@v12-engine/engine 0.1.1 → 0.4.0

package/dist/hero.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hero.js","names":[],"sources":["../src/hero.ts"],"sourcesContent":["import { heroLevelUp, heroRevived, xpGained } from '#engine/engineEvents'\nimport { type CallingDef, defaultCallings } from './callings'\nimport { defineComponent, snapshotOf } from './components'\nimport type { Cost } from './defs'\nimport { type Entity, type EntityId, fighting, moving, type PlayerId } from './entity'\nimport { defineEngineEvent } from './events'\nimport type { Vec2 } from './math'\nimport { refreshVitals, statsOf } from './stats'\nimport { readyAgain } from './abilities/charges'\nimport type { World } from './world'\nimport { agentParamsOf } from './navigation/agentParams'\nimport { engineMessage } from './messages'\nimport type { EntityState, LearnableInfo, XpInfo } from './session/protocol'\nimport { currencyOf } from './player'\nimport type { GamePack } from './packs/pack'\nimport { replicateEvent } from './replication'\nimport type { HeroSummary } from './session/protocol'\nimport { productionOf } from './systems/productionQueue'\nimport { learnedInForm, learnsOf } from './formState'\n\n/**\n * The id of the heroes pack (`heroesPack`): `hasPack(game, HEROES)`\n *\n * @beta\n */\nexport const HEROES = 'core.heroes'\n\n/**\n * The numbers and formulas of heroes, the heroes pack's (`heroesPack(rules)`): how many heroes a player may\n * have, how much experience a level takes, what bringing one back costs. The classic RTS numbers for\n * those left out\n *\n * @beta\n */\nexport interface HeroSettings {\n\t/** Heroes a player can have at once, fallen ones and ones being trained included */\n\tmaxHeroes: number\n\t/** The level heroes stop at, unless their type says otherwise (`HeroDef.maxLevel`) */\n\tmaxHeroLevel: number\n\t/** Heroes this close to a kill get a share of the experience */\n\txpRange: number\n\t/** Experience needed in total to be of a level. Level 1 must need none */\n\txpForLevel(level: number): number\n\t/** Experience a kill is worth, for units whose type does not say (`UnitTypeDef.xp`) */\n\tkillXp(world: World, dead: Entity): number\n\t/** What it costs to bring a fallen hero back, in the game's money, and how long it takes in seconds */\n\trevive(world: World, hero: Entity): { cost: Cost; time: number }\n\t/** Ability points a hero gets for reaching a level. One, when left out */\n\tpointsForLevel(level: number): number\n\t/** Seconds a fallen hero is remembered as it fell (`fallenHeroes`): 8 when left out */\n\tfallenFor: number\n\t/**\n\t * Seconds within which a hero that hurt a hero, or healed, shielded or buffed the hero that killed it, assists the\n\t * kill (`heroAssists`): it shares the kill's experience wherever it is, and is paid `assistGold`. 10 when left out;\n\t * 0 for no assists\n\t */\n\tassistTime: number\n\t/**\n\t * Which heroes assist a hero's kill, of those the engine found (`foundAssists`: who hurt it and who helped its\n\t * killer within `assistTime`): all of them when left out. A game's own rule (only those near, only damage)\n\t */\n\tassists(world: World, victim: Entity, killer: Entity | undefined, found: readonly Entity[]): readonly Entity[]\n\t/**\n\t * Gold the player of each hero that assists a hero's kill is paid. Half of what the kill is worth (its bounty's\n\t * middle, or 100 and 25 a level of the victim's: `heroKillWorth`), shared out among them, when left out\n\t */\n\tassistGold(world: World, victim: Entity, killer: Entity | undefined, assists: readonly Entity[]): number\n\t/**\n\t * Gold a hero's death pays its killer's player on top of the kill, for the kills it made in a row without dying\n\t * (`streak`): the shutdown that ends a streak. None under 3, then 100, and 50 more for each kill past it, 500 at\n\t * most, when left out\n\t */\n\tshutdownGold(world: World, victim: Entity, streak: number): number\n\t/**\n\t * What buying a fallen hero back costs its player (`buyBack`): 100 and 40 a level of its, in the game's money, when\n\t * left out. Nothing for a hero that cannot be bought back: a game without buyback says `() => undefined`\n\t */\n\tbuybackCost(world: World, hero: Entity): Cost | undefined\n\t/** Seconds a hero bought back waits before it may be again: 120 when left out */\n\tbuybackCooldown: number\n\t/**\n\t * The callings a hero may have (`HeroDef.callings`): the engine's when left out (`defaultCallings`), or a game's\n\t * own, some of them, renamed or added to: `heroesPack({ callings: [...] })`\n\t *\n\t * @beta\n\t */\n\tcallings: readonly CallingDef[]\n}\n\n/**\n * What the kill of a hero is worth in the game's money, as the engine's rules have it (what assists share,\n * `HeroSettings.assistGold`): the middle of its bounty (`UnitTypeDef.bounty`), or 100 and 25 a level\n *\n * @beta\n */\nexport function heroKillWorth(victim: Entity): number {\n\tconst bounty = victim.def.bounty\n\tif (bounty) return (bounty[0] + bounty[1]) / 2\n\treturn 100 + 25 * (heroOf(victim)?.level ?? 1)\n}\n\n/**\n * The heroes pack's rules where a game says nothing: the classic RTS numbers\n *\n * @internal\n */\nexport const defaultHeroSettings: Readonly<HeroSettings> = Object.freeze({\n\tmaxHeroes: 3,\n\tmaxHeroLevel: 10,\n\txpRange: 20,\n\t// 200, 500, 900, 1400, ...\n\txpForLevel: (level: number) => 50 * (level - 1) * (level + 2),\n\tkillXp(world: World, dead: Entity) {\n\t\tconst hero = heroOf(dead)\n\t\tif (hero) return 100 * hero.level\n\t\tif (!dead.isUnit) return 0\n\t\t// a quarter of what it cost in the game's money\n\t\treturn Math.max(Math.round(currencyOf(world.registry, dead.def.cost) / 4), 10)\n\t},\n\trevive(world: World, hero: Entity) {\n\t\tconst level = heroOf(hero)?.level ?? 1\n\t\tconst { currency } = world.registry\n\t\tconst paid = currencyOf(world.registry, hero.def.cost)\n\t\tconst cost: Cost = currency ? { [currency]: Math.min(Math.round(paid * (0.4 + 0.1 * level)), 700) } : {}\n\t\treturn { cost, time: Math.min((hero.def.buildTime ?? 30) * 0.5 + 4 * level, 110) }\n\t},\n\tpointsForLevel: () => 1,\n\tfallenFor: 8,\n\tassistTime: 10,\n\tassists: (_world: World, _victim: Entity, _killer: Entity | undefined, found: readonly Entity[]) => found,\n\tassistGold: (_world: World, victim: Entity, _killer: Entity | undefined, assists: readonly Entity[]) =>\n\t\tassists.length ? Math.round(heroKillWorth(victim) / 2 / assists.length) : 0,\n\tshutdownGold: (_world: World, _victim: Entity, streak: number) => (streak < 3 ? 0 : Math.min(100 + 50 * (streak - 3), 500)),\n\tbuybackCost(world: World, hero: Entity) {\n\t\tconst { currency } = world.registry\n\t\treturn currency ? { [currency]: 100 + 40 * (heroOf(hero)?.level ?? 1) } : undefined\n\t},\n\tbuybackCooldown: 120,\n\tcallings: Object.freeze(defaultCallings())\n})\n\n/**\n * The heroes pack, as `heroesPack` makes it: its rules beside its parts\n *\n * @beta\n */\nexport interface HeroesPack extends GamePack {\n\t/** What the game says of heroes, over the engine's (`defaultHeroSettings`): what the pack was made with (`RuleSettings.heroes`) */\n\toptions: Partial<HeroSettings>\n\t/** The callings its heroes may have: the game's (`heroesPack({ callings })`) or the engine's (`defaultCallings`) @beta */\n\tcallings: readonly CallingDef[]\n}\n\n/**\n * What a hero has earned: its level, its experience, the points it has to put into abilities (`heroState`)\n *\n * @beta\n */\nexport interface HeroState {\n\t/** The hero's level */\n\tlevel: number\n\t/** Experience in total */\n\txp: number\n\t/** Points that can be put into abilities */\n\tpoints: number\n}\n\n/**\n * What a player is told of a hero (`heroState`): its level, to everyone who sees it; its experience to its side, and to\n * everyone where the rules share it (`RuleSettings.hud.shareXp`); the points it has to spend and what it can learn, to its\n * side\n *\n * @beta\n */\nexport interface HeroSent {\n\t/** The hero's level, which everyone who sees the hero is told */\n\tlevel: number\n\t/** Its experience: its side's, and everyone's where the rules share it */\n\txp?: XpInfo\n\t/** Points it has to put into abilities: its side's */\n\tpoints?: number\n\t/** The abilities it can put points into, how far and whether now: its side's */\n\tlearnable?: LearnableInfo[]\n}\n\n/** A hero's experience: what it has, what its level took and what the next takes */\nfunction xpOf(world: World, entity: Entity, hero: HeroState): XpInfo {\n\treturn {\n\t\txp: Math.floor(hero.xp),\n\t\tlevelXp: world.settings.heroes.xpForLevel(hero.level),\n\t\tnextXp: world.settings.heroes.xpForLevel(Math.min(hero.level + 1, maxLevelOf(world, entity)))\n\t}\n}\n\nconst sameXp = (a: XpInfo | undefined, b: XpInfo | undefined) =>\n\ta === b || (!!a && !!b && a.xp === b.xp && a.levelXp === b.levelXp && a.nextXp === b.nextXp)\n\n/**\n * A hero: what it has earned (`HeroState`). Set as a unit of a type that says it is one (`UnitTypeDef.hero`) is made,\n * filed by owner (`world.index.with(heroState, player)`, `heroesOf`). What is a hero is what has it: a fallen hero stays\n * in the world's entities, out of the world, to be brought back\n *\n * @beta\n */\nexport const heroState = defineComponent<HeroState, HeroSent>({ id: 'core.hero', replicate: 'everyone',\n\tindex: 'owner',\n\tsnapshot(hero, entity, { world, ally }) {\n\t\tconst sent: HeroSent = { level: hero.level }\n\t\tconst def = entity.def.hero\n\t\tif (!def) return sent\n\t\tconst shareXp = world.settings.hud.shareXp\n\t\tconst shared =\n\t\t\tshareXp !== undefined && (typeof shareXp === 'function' ? (shareXp as (world: World, entity: Entity) => boolean)(world, entity) : shareXp)\n\t\tif (ally || shared) sent.xp = xpOf(world, entity, hero)\n\t\tif (!ally) return sent\n\t\tsent.points = hero.points\n\t\tsent.learnable = learnsOf(entity).map((id) => ({\n\t\t\tid,\n\t\t\tlevel: entity.abilities.find((ability) => ability.id === id)?.level ?? 0,\n\t\t\tmaxLevel: world.registry.ability(id).maxLevel ?? 3,\n\t\t\tneeds: levelNeeded(world, entity, id),\n\t\t\tavailable: canLearn(world, entity, id)\n\t\t}))\n\t\treturn sent\n\t},\n\tsame: (a, b) =>\n\t\ta.level === b.level &&\n\t\tsameXp(a.xp, b.xp) &&\n\t\ta.points === b.points &&\n\t\t(a.learnable === b.learnable ||\n\t\t\t(!!a.learnable &&\n\t\t\t\t!!b.learnable &&\n\t\t\t\ta.learnable.length === b.learnable.length &&\n\t\t\t\ta.learnable.every((info, i) => {\n\t\t\t\t\tconst other = b.learnable![i]\n\t\t\t\t\treturn (\n\t\t\t\t\t\tinfo.id === other.id &&\n\t\t\t\t\t\tinfo.level === other.level &&\n\t\t\t\t\t\tinfo.maxLevel === other.maxLevel &&\n\t\t\t\t\t\tinfo.needs === other.needs &&\n\t\t\t\t\t\tinfo.available === other.available\n\t\t\t\t\t)\n\t\t\t\t}))) })\n\n/**\n * What a hero has earned: none for what is no hero (`heroState`)\n *\n * @public\n */\nexport const heroOf = (entity: Entity): HeroState | undefined => entity.get(heroState)\n\n/**\n * What a player was told of a hero in their snapshot (`heroState`): its level to everyone, its experience, points and\n * what it can learn to its side. None for what is no hero\n *\n * @beta\n */\nexport const heroOfState = (state: EntityState): HeroSent | undefined => snapshotOf(state, heroState)\n\n/**\n * The level a hero stops at\n *\n * @beta\n */\nexport const maxLevelOf = (world: World, entity: Entity) => entity.def.hero?.maxLevel ?? world.settings.heroes.maxHeroLevel\n\n/**\n * Gives a hero experience: `from` what was killed, when that is where it comes from. The `beforeXp` hook has its say\n *\n * @beta\n */\nexport function grantXp(world: World, entity: Entity, amount: number, from?: Entity): void {\n\tconst hero = heroOf(entity)\n\tconst max = maxLevelOf(world, entity)\n\tconst { xpForLevel, pointsForLevel } = world.settings.heroes\n\tif (!hero || !entity.alive || hero.level >= max) return\n\tif (world.hooks.has('beforeXp')) amount = world.hooks.run('beforeXp', { hero: entity, from, amount }).amount\n\tif (amount <= 0) return\n\thero.xp += amount\n\twhile (hero.level < max && hero.xp >= xpForLevel(hero.level + 1)) {\n\t\thero.level++\n\t\thero.points += pointsForLevel(hero.level)\n\t\trefreshVitals(world, entity)\n\t\tkeepInnate(world, entity)\n\t\tworld.events.emit(heroLevelUp, { hero: entity, level: hero.level })\n\t\tworld.message(entity.owner, engineMessage('heroLevel', { unit: entity.def.id, level: hero.level }), 'info')\n\t}\n\tif (hero.level >= max) hero.xp = xpForLevel(max)\n\tworld.events.emit(xpGained, { hero: entity, amount, level: hero.level, from })\n}\n\n/**\n * The level of a hero's innate (`HeroDef.innate`) at a level of the hero: one for each of `innateLevels` it reached,\n * or the hero's own level where it says none; never past the ability's `maxLevel` where it says one. 0 before the first\n *\n * @beta\n */\nexport function innateLevel(world: World, entity: Entity, heroLevel = heroOf(entity)?.level ?? 1): number {\n\tconst def = entity.def.hero\n\tif (!def?.innate) return 0\n\tconst own = def.innateLevels ? def.innateLevels.filter((at) => heroLevel >= at).length : heroLevel\n\treturn Math.max(Math.min(own, world.registry.ability(def.innate).maxLevel ?? Infinity), 0)\n}\n\n/**\n * Gives a hero its innate (`HeroDef.innate`) where it has it not, at the level its own level says (`innateLevel`): as it\n * is made, as it gains a level, as it takes another form. It costs no point, and is none of those it learns\n *\n * @beta\n */\nexport function keepInnate(world: World, entity: Entity): void {\n\tconst id = entity.def.hero?.innate\n\tif (!id || !entity.has(heroState)) return\n\tconst level = innateLevel(world, entity)\n\tconst state = entity.abilities.find((each) => each.id === id)\n\tif (!state) entity.addAbility({ id: world.registry.ability(id).id, level, cooldown: 0, autocast: world.registry.ability(id).autocast ?? false })\n\telse if (state.level !== level) state.level = level\n}\n\n/**\n * Puts a hero at a level as if it had got there: the points to spend, the stats that grew, the experience of that\n * level. No message, no event and no `beforeXp`: for a hero that starts a map at that level, not one that earns it.\n * Never down\n *\n * @beta\n */\nexport function setHeroLevel(world: World, entity: Entity, level: number): void {\n\tconst hero = heroOf(entity)\n\tif (!hero) return\n\tconst to = Math.min(Math.floor(level), maxLevelOf(world, entity))\n\tif (to <= hero.level) return\n\twhile (hero.level < to) {\n\t\thero.level++\n\t\thero.points += world.settings.heroes.pointsForLevel(hero.level)\n\t}\n\thero.xp = world.settings.heroes.xpForLevel(to)\n\trefreshVitals(world, entity)\n\tkeepInnate(world, entity)\n}\n\n/**\n * Experience a kill is worth\n *\n * @beta\n */\nexport function xpWorth(world: World, entity: Entity): number {\n\treturn entity.def.xp ?? world.settings.heroes.killXp(world, entity)\n}\n\n/**\n * Hero level needed to put the next point into an ability\n *\n * @beta\n */\nexport function levelNeeded(world: World, hero: Entity, ability: string): number {\n\tconst def = world.registry.ability(ability)\n\tconst state = hero.abilities.find((a) => a.id === ability)\n\treturn (def.requiresLevel ?? (def.ultimate ? 6 : 1)) + (def.levelStep ?? 2) * (state?.level ?? 0)\n}\n\n/**\n * Whether a hero may put a point into an ability now: by points, levels and its learning, and the `canLearn` hook\n *\n * @beta\n */\nexport function canLearn(world: World, hero: Entity, ability: string): boolean {\n\tconst state = heroOf(hero)\n\tif (!state || !hero.alive || state.points <= 0) return false\n\tif (!hero.def.hero || !learnsOf(hero).includes(ability) || !world.registry.abilities.has(ability)) return false\n\tconst learned = hero.abilities.find((a) => a.id === ability)\n\tif (!learned || learned.level >= (world.registry.ability(ability).maxLevel ?? 3)) return false\n\tconst allowed = state.level >= levelNeeded(world, hero, ability)\n\treturn world.hooks.has('canLearn') ? !world.hooks.run('canLearn', { hero, ability, cancelled: !allowed }).cancelled : allowed\n}\n\n/**\n * Teaches the hero one level of an ability and spends a point on it; returns false when `canLearn` says it cannot\n *\n * @public\n */\nexport function learn(world: World, hero: Entity, ability: string): boolean {\n\tif (!canLearn(world, hero, ability)) return false\n\tconst state = hero.abilities.find((a) => a.id === ability)!\n\tstate.level++\n\theroOf(hero)!.points--\n\tif (state.level === 1) state.autocast = world.registry.ability(ability).autocast ?? false\n\t// in a form, its own whose level it has too\n\tlearnedInForm(hero, ability)\n\treturn true\n}\n\n/**\n * Heroes a player has, fallen ones included\n *\n * @beta\n */\nexport function heroesOf(world: World, player: number): Entity[] {\n\treturn [...world.index.with(heroState, player)]\n}\n\n/**\n * What it costs to bring a hero back, in the game's money, and how long it takes\n *\n * @beta\n */\nexport function reviveCost(world: World, hero: Entity): { cost: Cost; time: number } {\n\treturn world.settings.heroes.revive(world, hero)\n}\n\n/**\n * Puts a fallen hero back into the world\n *\n * @beta\n */\nexport function reviveHero(world: World, hero: Entity, at: Vec2): void {\n\tif (hero.alive || !hero.has(heroState)) return\n\tconst point = (hero.flying ? world.air : world.nav).closestPoint(at, 8) ?? at\n\thero.setAlive(true)\n\thero.setInside(false)\n\thero.reviving = false\n\thero.health = hero.maxHealth\n\thero.mana = hero.maxMana\n\thero.clearBuffs()\n\thero.keepOrders()\n\tfor (const ability of hero.abilities) readyAgain(ability)\n\thero.moveTo(point.x, point.z)\n\thero.prevPos.x = point.x\n\thero.prevPos.z = point.z\n\tconst m = hero.get(moving)\n\tif (m) {\n\t\tm.status = 'idle'\n\t\tm.anchored = false\n\t\tm.ghost = false\n\t\tdelete m.phased\n\t\tm.finalFacing = null\n\t\tm.speed = statsOf(world, hero).moveSpeed\n\t\tworld.nav.addAgent(hero.id, point, agentParamsOf(hero, m.speed))\n\t}\n\tif (hero.get(fighting))\n\t\tObject.assign(hero.get(fighting)!, { cooldown: 0, swing: 0, swingTarget: 0, autoTarget: 0, lastAttacker: 0, guard: null, passive: false })\n\tworld.events.emit(heroRevived, hero)\n}\n\n/**\n * A fallen hero waiting to come back: when it fell, and how long it waits, in seconds of the game\n *\n * @internal\n */\nexport const respawning = defineComponent<{ since: number; wait: number }>({ id: 'core.respawning' })\n\n/**\n * How long until a fallen hero comes back by itself, in seconds: none for one that is not waiting\n *\n * @beta\n */\nexport function respawnIn(world: World, hero: Entity): number | undefined {\n\tconst waiting = hero.get(respawning)\n\treturn waiting && !hero.alive ? Math.max(0, waiting.since + waiting.wait - world.time) : undefined\n}\n\n/** A hero back, to those who see it */\nexport const toldRevived = replicateEvent(heroRevived, 'revived', (hero, view) => (view.knows(hero) ? { type: 'revived', id: hero.id } : undefined))\n\n/** A hero's new level, to those who see it */\nexport const toldLevelUp = replicateEvent(heroLevelUp, 'levelUp', ({ hero, level }, view) =>\n\tview.knows(hero) ? { type: 'levelUp', id: hero.id, level } : undefined\n)\n\n/** Experience gained: its side's alone, an enemy sees a bar move, not why */\nexport const toldXp = replicateEvent(xpGained, 'xp', ({ hero, amount, level }, view) =>\n\tview.isAlly(hero.owner) ? { type: 'xp', id: hero.id, amount, level } : undefined\n)\n\n/**\n * A player's heroes, as their portraits show them (`PlayerState.own.heroes`): their level, health and mana, and how far\n * a fallen one is through being brought back, at an altar or by itself\n *\n * @beta\n */\nexport function heroSummaries(world: World, player: PlayerId): HeroSummary[] {\n\tconst reviving = new Map<number, number>()\n\tfor (const entity of world.index.ownedBy(player)) {\n\t\tconst production = productionOf(entity)\n\t\tif (!production) continue\n\t\tfor (const item of production.queue) if (item.kind === 'revive') reviving.set(Number(item.id), item.progress / item.duration)\n\t}\n\treturn heroesOf(world, player).map((entity) => ({\n\t\tid: entity.id,\n\t\ttype: entity.def.id,\n\t\tlevel: heroOf(entity)!.level,\n\t\talive: entity.alive,\n\t\thealth: entity.alive ? entity.health / entity.maxHealth : 0,\n\t\tmana: entity.alive && entity.maxMana > 0 ? entity.mana / entity.maxMana : 0,\n\t\tpoints: heroOf(entity)!.points,\n\t\treviving: reviving.get(entity.id) ?? respawnProgress(world, entity),\n\t\t...(respawnIn(world, entity) !== undefined && { respawnIn: respawnIn(world, entity) }),\n\t\treviveCost: entity.alive ? undefined : reviveCost(world, entity).cost\n\t}))\n}\n\n/** How far a fallen hero is through its wait to come back by itself, 0..1: none for one that is not waiting */\nfunction respawnProgress(world: World, hero: Entity): number | undefined {\n\tconst waiting = hero.get(respawning)\n\tif (!waiting || hero.alive) return undefined\n\treturn waiting.wait > 0 ? Math.min(1, (world.time - waiting.since) / waiting.wait) : 1\n}\n\n// ---- the hero loop's events (the heroes pack's `packs/heroes/loop.ts`), here for the score to count\n\n/**\n * A hero shared a kill as an assist (`heroAssists`): who, of whom, who killed it, and the gold its player was paid for it\n *\n * @beta\n */\nexport const heroAssisted = defineEngineEvent<{ hero: EntityId; type: string; player: PlayerId; victim: EntityId; killer?: EntityId; gold: number }>({\n\tid: 'core.heroAssisted',\n\treplicate: 'everyone'\n})\n\n/**\n * A hero killed another and is on a streak of this many since it last died\n *\n * @beta\n */\nexport const killStreak = defineEngineEvent<{ hero: EntityId; type: string; player: PlayerId; streak: number }>({\n\tid: 'core.killStreak',\n\treplicate: 'everyone'\n})\n\n/**\n * A hero on a streak fell (`HeroSettings.shutdownGold`): whose streak of how many, and the gold its killer's player was\n * paid on top of the kill for ending it\n *\n * @beta\n */\nexport const heroShutdown = defineEngineEvent<{ hero: EntityId; streak: number; killer?: EntityId; player?: PlayerId; gold: number }>({\n\tid: 'core.shutdown',\n\treplicate: 'everyone'\n})\n\n/**\n * A fallen hero was bought back (`buyBack`): who, for whom, at what cost\n *\n * @beta\n */\nexport const boughtBack = defineEngineEvent<{ hero: EntityId; type: string; player: PlayerId; cost: Cost }>({\n\tid: 'core.boughtBack',\n\treplicate: 'everyone'\n})\n"],"mappings":"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"}

package/dist/holds.d.ts

@@ -0,0 +1,94 @@
+import type { Entity } from './entity';
+import type { Vec2 } from './math';
+import { type CastChannel } from './orders/cast';
+import type { GamePack } from './packs/pack';
+import type { World } from './world';
+/**
+ * The holds pack's id
+ *
+ * @beta
+ */
+export declare const HOLDS = "core.holds";
+/**
+ * What a unit aims as it goes, told to its owner (whose pointer aims it): an ability it holds to charge (`held`: the
+ * seconds held), or one it channels aimed (`AbilityDef.channel.aimed`, no `held`); where it was last aimed
+ *
+ * @beta
+ */
+export interface Aiming {
+    /** The ability */
+    ability: string;
+    /** The level it is cast at */
+    level: number;
+    /** Seconds it has been held, for one held to charge: none for a channel */
+    held?: number;
+    /** Where it was last aimed */
+    point?: Vec2;
+}
+/**
+ * What a unit aims as it goes (`Aiming`): while it holds an ability to charge, or channels one aimed. Told to its owner
+ *
+ * @beta
+ */
+export declare const aiming: import("./components").Component<Aiming, Aiming>;
+/**
+ * A channel a unit keeps up as it walks (`AbilityDef.channel.walks`), as the cast order keeps one it stands in
+ * (`CastChannel`)
+ *
+ * @beta
+ */
+export declare const walkingChannel: import("./components").Component<CastChannel, CastChannel>;
+/**
+ * How full an ability held to charge is (`AbilityDef.hold`), 0 to 1: none where the unit holds nothing
+ *
+ * @beta
+ */
+export declare function heldShare(world: World, entity: Entity): number | undefined;
+/**
+ * Lets go of what a unit holds to charge (`AbilityDef.hold`), at `point` (where it was last aimed when left out): it
+ * goes off as full as it was held, paid for then (`fire`), or a tap's effects where it was let go soon. False where it
+ * held nothing, or what it held could not go off (the player told why)
+ *
+ * @beta
+ */
+export declare function releaseHold(world: World, entity: Entity, point?: Vec2): boolean;
+/**
+ * Aims what a unit aims as it goes (`Aiming`) at a point: what it holds to charge, or the channel it keeps up aimed
+ * (`channel.aimed`: where it goes off at from now on, the caster turned to it). What the `aim` command does
+ *
+ * @beta
+ */
+export declare function aimAt(_world: World, entity: Entity, point: Vec2): void;
+/**
+ * Lets go of what the player's units hold of an ability (`releaseHold`): what the screen sends as the key is let go, or
+ * on a click, with where the pointer is
+ *
+ * @beta
+ */
+export declare const releaseCommand: import("#engine/commands").DefinedCommand<"release", {
+    entities: import("./fields").Check<number[] | undefined>;
+    ability: import("./fields").Check<string>;
+    point: import("./fields").Check<Vec2 | undefined>;
+}>;
+/**
+ * Aims what the player's units aim as they go of an ability (`aimAt`): what the screen sends, ten times a second at the
+ * most, while one holds or channels it, for where the pointer is
+ *
+ * @beta
+ */
+export declare const aimCommand: import("#engine/commands").DefinedCommand<"aim", {
+    ability: import("./fields").Check<string>;
+    point: import("./fields").Check<Vec2>;
+}>;
+/**
+ * Holds and channels aimed as they go: what a game with it (`Rules.packs`) gets for abilities held to charge and let go
+ * (`AbilityDef.hold`: cast, the hold starts where the caster stands, and it goes on with what it was doing; the `release`
+ * command, the key let go or a click, sets it off as full as it was held: `HoldDef.range`, `scale`, a `tap`'s other
+ * effects; it goes off by itself at `upTo`; a stun, a silence or its death lets go of it for nothing), channels aimed as
+ * they go (`channel.aimed`: the `aim` command moves where they go off at) and channels kept up as the caster walks
+ * (`channel.walks`). What a unit aims as it goes is the `aiming` component, told to its owner; `releaseHold`, `aimAt` and
+ * `heldShare` in code
+ *
+ * @beta
+ */
+export declare function holdsPack(): GamePack;

package/dist/holds.js

@@ -0,0 +1,305 @@
+import { atan2, cos, hypot, sin } from "./exactMath.js";
+import { defineComponent } from "./components.js";
+import { defineListener } from "./events.js";
+import { channelEnded, channelStarted } from "./engineEvents.js";
+import { applyBuff, isSilenced, isStunned, removeBuff } from "./abilities/buffs.js";
+import { defineHook } from "./hooks.js";
+import { ids, optional, point, string } from "./fields.js";
+import { channelling, fire, notReady } from "./orders/cast.js";
+import { defineCommand } from "./commands.js";
+//#region src/holds.ts
+/**
+* The holds pack's id
+*
+* @beta
+*/
+var HOLDS = "core.holds";
+/**
+* What a unit aims as it goes (`Aiming`): while it holds an ability to charge, or channels one aimed. Told to its owner
+*
+* @beta
+*/
+var aiming = /* @__PURE__ */ defineComponent({
+	id: "core.aiming",
+	replicate: "owner",
+	index: true,
+	refs: (saved) => ({ abilities: [saved.ability] })
+});
+/**
+* A channel a unit keeps up as it walks (`AbilityDef.channel.walks`), as the cast order keeps one it stands in
+* (`CastChannel`)
+*
+* @beta
+*/
+var walkingChannel = /* @__PURE__ */ defineComponent({
+	id: "core.walkingChannel",
+	index: true,
+	refs: (saved) => ({ abilities: [saved.ability] })
+});
+/**
+* How full an ability held to charge is (`AbilityDef.hold`), 0 to 1: none where the unit holds nothing
+*
+* @beta
+*/
+function heldShare(world, entity) {
+	const held = entity.get(aiming);
+	if (held?.held === void 0 || !world.registry.abilities.has(held.ability)) return void 0;
+	const hold = world.registry.ability(held.ability).hold;
+	return hold ? Math.min(held.held / Math.max(hold.max, 1e-6), 1) : void 0;
+}
+/** Where a hold let go at `aimed` goes off: brought as near as its reach held so long */
+function reachedPoint(caster, ability, share, aimed) {
+	const range = ability.hold?.range;
+	if (!range) return aimed;
+	const reach = range.from + (range.to - range.from) * share;
+	const dx = aimed.x - caster.pos.x;
+	const dz = aimed.z - caster.pos.z;
+	const far = hypot(dx, dz);
+	if (far <= reach) return aimed;
+	const way = far > 1e-6 ? atan2(dx, dz) : caster.facing;
+	return {
+		x: caster.pos.x + sin(way) * reach,
+		z: caster.pos.z + cos(way) * reach
+	};
+}
+/** No longer held: the hold's buff off, the component gone */
+function drop(world, entity, held) {
+	entity.remove(aiming);
+	if (!world.registry.abilities.has(held.ability)) return;
+	const buff = world.registry.ability(held.ability).hold?.buff;
+	if (buff) removeBuff(world, entity, buff, entity);
+}
+/**
+* Lets go of what a unit holds to charge (`AbilityDef.hold`), at `point` (where it was last aimed when left out): it
+* goes off as full as it was held, paid for then (`fire`), or a tap's effects where it was let go soon. False where it
+* held nothing, or what it held could not go off (the player told why)
+*
+* @beta
+*/
+function releaseHold(world, entity, point) {
+	const held = entity.get(aiming);
+	if (held?.held === void 0 || !world.registry.abilities.has(held.ability)) return false;
+	const ability = world.registry.ability(held.ability);
+	const hold = ability.hold;
+	const share = heldShare(world, entity) ?? 0;
+	drop(world, entity, held);
+	const state = entity.abilities.find((each) => each.id === ability.id);
+	if (!hold || !state || !entity.alive) return false;
+	const problem = notReady(world, entity, ability);
+	if (problem) {
+		world.message(entity.owner, problem);
+		return false;
+	}
+	const at = reachedPoint(entity, ability, share, point ?? held.point ?? entity.pos);
+	if (hypot(at.x - entity.pos.x, at.z - entity.pos.z) > .05) entity.facing = atan2(at.x - entity.pos.x, at.z - entity.pos.z);
+	state.point = {
+		x: at.x,
+		z: at.z
+	};
+	const tap = hold.tap && held.held < hold.tap.under ? hold.tap.effects : void 0;
+	fire(world, entity, ability, void 0, void 0, {
+		share,
+		...tap && { effects: tap }
+	});
+	return true;
+}
+/**
+* Aims what a unit aims as it goes (`Aiming`) at a point: what it holds to charge, or the channel it keeps up aimed
+* (`channel.aimed`: where it goes off at from now on, the caster turned to it). What the `aim` command does
+*
+* @beta
+*/
+function aimAt(_world, entity, point) {
+	const held = entity.get(aiming);
+	if (!held) return;
+	held.point = {
+		x: point.x,
+		z: point.z
+	};
+	if (held.held !== void 0) return;
+	const channel = channelOf(entity, held.ability);
+	if (!channel) return;
+	channel.point = {
+		x: point.x,
+		z: point.z
+	};
+	if (hypot(point.x - entity.pos.x, point.z - entity.pos.z) > .05) entity.facing = atan2(point.x - entity.pos.x, point.z - entity.pos.z);
+}
+/** The channel of an ability a unit keeps up: in its cast order, or as it walks */
+function channelOf(entity, ability) {
+	const walking = entity.get(walkingChannel);
+	if (walking?.ability === ability) return walking;
+	const order = entity.orders[0];
+	const channel = order?.type === "cast" ? order.state.channel : void 0;
+	return channel?.ability === ability && !channel.done ? channel : void 0;
+}
+/**
+* Lets go of what the player's units hold of an ability (`releaseHold`): what the screen sends as the key is let go, or
+* on a click, with where the pointer is
+*
+* @beta
+*/
+var releaseCommand = /* @__PURE__ */ defineCommand("release", {
+	entities: optional(ids),
+	ability: string,
+	point: optional(point)
+}, (world, player, command) => {
+	for (const entity of [...world.index.with(aiming)]) {
+		if (entity.owner !== player || command.entities && !command.entities.includes(entity.id)) continue;
+		if (entity.get(aiming)?.ability === command.ability) releaseHold(world, entity, command.point);
+	}
+});
+/**
+* Aims what the player's units aim as they go of an ability (`aimAt`): what the screen sends, ten times a second at the
+* most, while one holds or channels it, for where the pointer is
+*
+* @beta
+*/
+var aimCommand = /* @__PURE__ */ defineCommand("aim", {
+	ability: string,
+	point
+}, (world, player, command) => {
+	for (const entity of world.index.with(aiming)) if (entity.owner === player && entity.get(aiming)?.ability === command.ability) aimAt(world, entity, command.point);
+});
+/** Holds charging, let go by themselves at their time; channels kept up as their casters walk */
+var holdsSystem = {
+	name: "holds",
+	phase: "decide",
+	before: ["abilities"],
+	update(world, dt) {
+		for (const entity of [...world.index.with(aiming)]) {
+			const held = entity.get(aiming);
+			if (held?.held === void 0) continue;
+			const ability = world.registry.abilities.has(held.ability) ? world.registry.ability(held.ability) : void 0;
+			if (!ability?.hold || !entity.alive || isStunned(world, entity) || isSilenced(world, entity, ability)) {
+				drop(world, entity, held);
+				continue;
+			}
+			held.held += dt;
+			if (held.held >= (ability.hold.upTo ?? ability.hold.max)) releaseHold(world, entity);
+		}
+		for (const entity of [...world.index.with(walkingChannel)]) {
+			const channel = entity.get(walkingChannel);
+			if (!channel) continue;
+			const ability = world.registry.abilities.has(channel.ability) ? world.registry.ability(channel.ability) : void 0;
+			if (ability && entity.alive && !isStunned(world, entity) && !isSilenced(world, entity, ability)) {
+				if (channelling(world, entity, channel, dt) === "running") continue;
+			} else if (ability && !channel.done) {
+				channel.done = true;
+				ability.channel?.interrupted?.(world, entity, channel.level);
+				world.events.emit(channelEnded, {
+					caster: entity,
+					ability,
+					interrupted: true
+				});
+			}
+			entity.remove(walkingChannel);
+		}
+	}
+};
+/**
+* Holds and channels aimed as they go: what a game with it (`Rules.packs`) gets for abilities held to charge and let go
+* (`AbilityDef.hold`: cast, the hold starts where the caster stands, and it goes on with what it was doing; the `release`
+* command, the key let go or a click, sets it off as full as it was held: `HoldDef.range`, `scale`, a `tap`'s other
+* effects; it goes off by itself at `upTo`; a stun, a silence or its death lets go of it for nothing), channels aimed as
+* they go (`channel.aimed`: the `aim` command moves where they go off at) and channels kept up as the caster walks
+* (`channel.walks`). What a unit aims as it goes is the `aiming` component, told to its owner; `releaseHold`, `aimAt` and
+* `heldShare` in code
+*
+* @beta
+*/
+function holdsPack() {
+	const press = defineHook({
+		hook: "beforeOrder",
+		id: "holds",
+		run(world, event) {
+			const { order, entity } = event;
+			const init = order.init;
+			if (order.type !== "cast" || !init.ability || init.item !== void 0 || !world.registry.abilities.has(init.ability)) return;
+			const ability = world.registry.ability(init.ability);
+			if (!ability.hold) return;
+			event.rejected = true;
+			const held = entity.get(aiming);
+			if (held?.ability === ability.id && held.held !== void 0) {
+				releaseHold(world, entity, init.point);
+				return;
+			}
+			const state = entity.abilities.find((each) => each.id === ability.id);
+			if (!state || state.level < 1 || held || isStunned(world, entity)) return;
+			const problem = notReady(world, entity, ability);
+			if (problem) {
+				world.message(entity.owner, problem);
+				return;
+			}
+			entity.set(aiming, {
+				ability: ability.id,
+				level: state.level,
+				held: 0,
+				...init.point && { point: {
+					x: init.point.x,
+					z: init.point.z
+				} }
+			});
+			if (ability.hold.buff && world.registry.buffs.has(ability.hold.buff)) applyBuff(world, entity, ability.hold.buff, void 0, entity, state.level, ability.id);
+		}
+	});
+	const walks = defineHook({
+		hook: "afterCast",
+		id: "holds",
+		run(world, event) {
+			const { caster, ability, level, target, point, item } = event;
+			const kept = ability.channel;
+			if (!kept?.walks || item || !caster.alive) return;
+			const seconds = typeof kept.duration === "function" ? kept.duration(world, caster, level) : kept.duration;
+			caster.set(walkingChannel, {
+				ability: ability.id,
+				level,
+				target: target?.id,
+				point: {
+					x: point.x,
+					z: point.z
+				},
+				left: seconds,
+				elapsed: 0
+			});
+			world.events.emit(channelStarted, {
+				caster,
+				ability,
+				duration: seconds
+			});
+		}
+	});
+	const aimed = defineListener({
+		id: "holds.aimed",
+		event: channelStarted,
+		run(_world, { caster, ability }) {
+			if (ability.channel?.aimed && caster.alive && !caster.get(aiming)) {
+				const level = caster.abilities.find((each) => each.id === ability.id)?.level ?? 1;
+				caster.set(aiming, {
+					ability: ability.id,
+					level
+				});
+			}
+		}
+	});
+	const ended = defineListener({
+		id: "holds.ended",
+		event: channelEnded,
+		run(_world, { caster, ability }) {
+			const held = caster.get(aiming);
+			if (held && held.held === void 0 && held.ability === ability.id && !channelOf(caster, ability.id)) caster.remove(aiming);
+		}
+	});
+	return {
+		id: HOLDS,
+		components: [aiming, walkingChannel],
+		commands: [releaseCommand, aimCommand],
+		systems: [holdsSystem],
+		hooks: [press, walks],
+		listeners: [aimed, ended]
+	};
+}
+//#endregion
+export { HOLDS, aimAt, aimCommand, aiming, heldShare, holdsPack, releaseCommand, releaseHold, walkingChannel };
+
+//# sourceMappingURL=holds.js.map

package/dist/holds.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"holds.js","names":[],"sources":["../src/holds.ts"],"sourcesContent":["import { applyBuff, isSilenced, isStunned, removeBuff } from './abilities/buffs'\nimport { defineComponent } from './components'\nimport { defineCommand } from './commands'\nimport type { AbilityDef } from './defs'\nimport { channelEnded, channelStarted } from './engineEvents'\nimport type { Entity } from './entity'\nimport { atan2, cos, hypot, sin } from './exactMath'\nimport { defineListener } from './events'\nimport { ids, optional, point, string } from './fields'\nimport { defineHook } from './hooks'\nimport type { Vec2 } from './math'\nimport { type CastChannel, channelling, fire, notReady } from './orders/cast'\nimport type { GamePack } from './packs/pack'\nimport type { System } from './registry'\nimport type { World } from './world'\n\n/*\n * Holds and channels aimed as they go, an opt-in pack (E2E-PLAN AB15): an ability held to charge and let go (farther,\n * harder, or a tap's other effects), a channel whose aim follows the player's, and one kept up as the caster walks. A\n * game without it pays nothing for these; a tether (`channel.leash`) is the engine's own\n */\n\n/**\n * The holds pack's id\n *\n * @beta\n */\nexport const HOLDS = 'core.holds'\n\n/**\n * What a unit aims as it goes, told to its owner (whose pointer aims it): an ability it holds to charge (`held`: the\n * seconds held), or one it channels aimed (`AbilityDef.channel.aimed`, no `held`); where it was last aimed\n *\n * @beta\n */\nexport interface Aiming {\n\t/** The ability */\n\tability: string\n\t/** The level it is cast at */\n\tlevel: number\n\t/** Seconds it has been held, for one held to charge: none for a channel */\n\theld?: number\n\t/** Where it was last aimed */\n\tpoint?: Vec2\n}\n\n/**\n * What a unit aims as it goes (`Aiming`): while it holds an ability to charge, or channels one aimed. Told to its owner\n *\n * @beta\n */\nexport const aiming = /* @__PURE__ */ defineComponent<Aiming>({\n\tid: 'core.aiming',\n\treplicate: 'owner',\n\tindex: true,\n\trefs: (saved) => ({ abilities: [(saved as Aiming).ability] })\n})\n\n/**\n * A channel a unit keeps up as it walks (`AbilityDef.channel.walks`), as the cast order keeps one it stands in\n * (`CastChannel`)\n *\n * @beta\n */\nexport const walkingChannel = /* @__PURE__ */ defineComponent<CastChannel>({\n\tid: 'core.walkingChannel',\n\tindex: true,\n\trefs: (saved) => ({ abilities: [(saved as CastChannel).ability] })\n})\n\n/**\n * How full an ability held to charge is (`AbilityDef.hold`), 0 to 1: none where the unit holds nothing\n *\n * @beta\n */\nexport function heldShare(world: World, entity: Entity): number | undefined {\n\tconst held = entity.get(aiming)\n\tif (held?.held === undefined || !world.registry.abilities.has(held.ability)) return undefined\n\tconst hold = world.registry.ability(held.ability).hold\n\treturn hold ? Math.min(held.held / Math.max(hold.max, 1e-6), 1) : undefined\n}\n\n/** Where a hold let go at `aimed` goes off: brought as near as its reach held so long */\nfunction reachedPoint(caster: Entity, ability: AbilityDef, share: number, aimed: Vec2): Vec2 {\n\tconst range = ability.hold?.range\n\tif (!range) return aimed\n\tconst reach = range.from + (range.to - range.from) * share\n\tconst dx = aimed.x - caster.pos.x\n\tconst dz = aimed.z - caster.pos.z\n\tconst far = hypot(dx, dz)\n\tif (far <= reach) return aimed\n\t// aimed at its feet: the way it faces\n\tconst way = far > 1e-6 ? atan2(dx, dz) : caster.facing\n\treturn { x: caster.pos.x + sin(way) * reach, z: caster.pos.z + cos(way) * reach }\n}\n\n/** No longer held: the hold's buff off, the component gone */\nfunction drop(world: World, entity: Entity, held: Aiming): void {\n\tentity.remove(aiming)\n\tif (!world.registry.abilities.has(held.ability)) return\n\tconst buff = world.registry.ability(held.ability).hold?.buff\n\tif (buff) removeBuff(world, entity, buff, entity)\n}\n\n/**\n * Lets go of what a unit holds to charge (`AbilityDef.hold`), at `point` (where it was last aimed when left out): it\n * goes off as full as it was held, paid for then (`fire`), or a tap's effects where it was let go soon. False where it\n * held nothing, or what it held could not go off (the player told why)\n *\n * @beta\n */\nexport function releaseHold(world: World, entity: Entity, point?: Vec2): boolean {\n\tconst held = entity.get(aiming)\n\tif (held?.held === undefined || !world.registry.abilities.has(held.ability)) return false\n\tconst ability = world.registry.ability(held.ability)\n\tconst hold = ability.hold\n\tconst share = heldShare(world, entity) ?? 0\n\tdrop(world, entity, held)\n\tconst state = entity.abilities.find((each) => each.id === ability.id)\n\tif (!hold || !state || !entity.alive) return false\n\tconst problem = notReady(world, entity, ability)\n\tif (problem) {\n\t\tworld.message(entity.owner, problem)\n\t\treturn false\n\t}\n\tconst aimed = point ?? held.point ?? entity.pos\n\tconst at = reachedPoint(entity, ability, share, aimed)\n\tif (hypot(at.x - entity.pos.x, at.z - entity.pos.z) > 0.05) entity.facing = atan2(at.x - entity.pos.x, at.z - entity.pos.z)\n\tstate.point = { x: at.x, z: at.z }\n\tconst tap = hold.tap && held.held < hold.tap.under ? hold.tap.effects : undefined\n\tfire(world, entity, ability, undefined, undefined, { share, ...(tap && { effects: tap }) })\n\treturn true\n}\n\n/**\n * Aims what a unit aims as it goes (`Aiming`) at a point: what it holds to charge, or the channel it keeps up aimed\n * (`channel.aimed`: where it goes off at from now on, the caster turned to it). What the `aim` command does\n *\n * @beta\n */\nexport function aimAt(_world: World, entity: Entity, point: Vec2): void {\n\tconst held = entity.get(aiming)\n\tif (!held) return\n\theld.point = { x: point.x, z: point.z }\n\tif (held.held !== undefined) return\n\tconst channel = channelOf(entity, held.ability)\n\tif (!channel) return\n\tchannel.point = { x: point.x, z: point.z }\n\tif (hypot(point.x - entity.pos.x, point.z - entity.pos.z) > 0.05) entity.facing = atan2(point.x - entity.pos.x, point.z - entity.pos.z)\n}\n\n/** The channel of an ability a unit keeps up: in its cast order, or as it walks */\nfunction channelOf(entity: Entity, ability: string): CastChannel | undefined {\n\tconst walking = entity.get(walkingChannel)\n\tif (walking?.ability === ability) return walking\n\tconst order = entity.orders[0]\n\tconst channel = order?.type === 'cast' ? (order.state.channel as CastChannel | undefined) : undefined\n\treturn channel?.ability === ability && !channel.done ? channel : undefined\n}\n\n/**\n * Lets go of what the player's units hold of an ability (`releaseHold`): what the screen sends as the key is let go, or\n * on a click, with where the pointer is\n *\n * @beta\n */\nexport const releaseCommand = /* @__PURE__ */ defineCommand('release', { entities: optional(ids), ability: string, point: optional(point) }, (world, player, command) => {\n\tfor (const entity of [...world.index.with(aiming)]) {\n\t\tif (entity.owner !== player || (command.entities && !command.entities.includes(entity.id))) continue\n\t\tif (entity.get(aiming)?.ability === command.ability) releaseHold(world, entity, command.point)\n\t}\n})\n\n/**\n * Aims what the player's units aim as they go of an ability (`aimAt`): what the screen sends, ten times a second at the\n * most, while one holds or channels it, for where the pointer is\n *\n * @beta\n */\nexport const aimCommand = /* @__PURE__ */ defineCommand('aim', { ability: string, point }, (world, player, command) => {\n\tfor (const entity of world.index.with(aiming)) if (entity.owner === player && entity.get(aiming)?.ability === command.ability) aimAt(world, entity, command.point)\n})\n\n/** Holds charging, let go by themselves at their time; channels kept up as their casters walk */\nconst holdsSystem: System = {\n\tname: 'holds',\n\tphase: 'decide',\n\tbefore: ['abilities'],\n\tupdate(world, dt) {\n\t\tfor (const entity of [...world.index.with(aiming)]) {\n\t\t\tconst held = entity.get(aiming)\n\t\t\tif (held?.held === undefined) continue\n\t\t\tconst ability = world.registry.abilities.has(held.ability) ? world.registry.ability(held.ability) : undefined\n\t\t\t// stunned, silenced or dead: let go of, for nothing\n\t\t\tif (!ability?.hold || !entity.alive || isStunned(world, entity) || isSilenced(world, entity, ability)) {\n\t\t\t\tdrop(world, entity, held)\n\t\t\t\tcontinue\n\t\t\t}\n\t\t\theld.held += dt\n\t\t\tif (held.held >= (ability.hold.upTo ?? ability.hold.max)) releaseHold(world, entity)\n\t\t}\n\t\tfor (const entity of [...world.index.with(walkingChannel)]) {\n\t\t\tconst channel = entity.get(walkingChannel)\n\t\t\tif (!channel) continue\n\t\t\tconst ability = world.registry.abilities.has(channel.ability) ? world.registry.ability(channel.ability) : undefined\n\t\t\tif (ability && entity.alive && !isStunned(world, entity) && !isSilenced(world, entity, ability)) {\n\t\t\t\tif (channelling(world, entity, channel, dt) === 'running') continue\n\t\t\t} else if (ability && !channel.done) {\n\t\t\t\tchannel.done = true\n\t\t\t\tability.channel?.interrupted?.(world, entity, channel.level)\n\t\t\t\tworld.events.emit(channelEnded, { caster: entity, ability, interrupted: true })\n\t\t\t}\n\t\t\tentity.remove(walkingChannel)\n\t\t}\n\t}\n}\n\n/**\n * Holds and channels aimed as they go: what a game with it (`Rules.packs`) gets for abilities held to charge and let go\n * (`AbilityDef.hold`: cast, the hold starts where the caster stands, and it goes on with what it was doing; the `release`\n * command, the key let go or a click, sets it off as full as it was held: `HoldDef.range`, `scale`, a `tap`'s other\n * effects; it goes off by itself at `upTo`; a stun, a silence or its death lets go of it for nothing), channels aimed as\n * they go (`channel.aimed`: the `aim` command moves where they go off at) and channels kept up as the caster walks\n * (`channel.walks`). What a unit aims as it goes is the `aiming` component, told to its owner; `releaseHold`, `aimAt` and\n * `heldShare` in code\n *\n * @beta\n */\nexport function holdsPack(): GamePack {\n\t// cast: the hold starts, in place of the order; cast again while held, it is let go\n\tconst press = defineHook({\n\t\thook: 'beforeOrder',\n\t\tid: 'holds',\n\t\trun(world, event) {\n\t\t\tconst { order, entity } = event\n\t\t\tconst init = order.init as { ability?: string; point?: Vec2; item?: number }\n\t\t\tif (order.type !== 'cast' || !init.ability || init.item !== undefined || !world.registry.abilities.has(init.ability)) return\n\t\t\tconst ability = world.registry.ability(init.ability)\n\t\t\tif (!ability.hold) return\n\t\t\tevent.rejected = true\n\t\t\tconst held = entity.get(aiming)\n\t\t\tif (held?.ability === ability.id && held.held !== undefined) {\n\t\t\t\treleaseHold(world, entity, init.point)\n\t\t\t\treturn\n\t\t\t}\n\t\t\tconst state = entity.abilities.find((each) => each.id === ability.id)\n\t\t\tif (!state || state.level < 1 || held || isStunned(world, entity)) return\n\t\t\tconst problem = notReady(world, entity, ability)\n\t\t\tif (problem) {\n\t\t\t\tworld.message(entity.owner, problem)\n\t\t\t\treturn\n\t\t\t}\n\t\t\tentity.set(aiming, { ability: ability.id, level: state.level, held: 0, ...(init.point && { point: { x: init.point.x, z: init.point.z } }) })\n\t\t\tif (ability.hold.buff && world.registry.buffs.has(ability.hold.buff)) applyBuff(world, entity, ability.hold.buff, undefined, entity, state.level, ability.id)\n\t\t}\n\t})\n\t// a channel kept up as the caster walks: the cast order is done, the pack keeps it up\n\tconst walks = defineHook({\n\t\thook: 'afterCast',\n\t\tid: 'holds',\n\t\trun(world, event) {\n\t\t\tconst { caster, ability, level, target, point, item } = event\n\t\t\tconst kept = ability.channel\n\t\t\tif (!kept?.walks || item || !caster.alive) return\n\t\t\tconst seconds = typeof kept.duration === 'function' ? kept.duration(world, caster, level) : kept.duration\n\t\t\tcaster.set(walkingChannel, { ability: ability.id, level, target: target?.id, point: { x: point.x, z: point.z }, left: seconds, elapsed: 0 })\n\t\t\tworld.events.emit(channelStarted, { caster, ability, duration: seconds })\n\t\t}\n\t})\n\t// a channel aimed as it goes: its caster aims it while it lasts\n\tconst aimed = defineListener({\n\t\tid: 'holds.aimed',\n\t\tevent: channelStarted,\n\t\trun(_world, { caster, ability }) {\n\t\t\tif (ability.channel?.aimed && caster.alive && !caster.get(aiming)) {\n\t\t\t\tconst level = caster.abilities.find((each) => each.id === ability.id)?.level ?? 1\n\t\t\t\tcaster.set(aiming, { ability: ability.id, level })\n\t\t\t}\n\t\t}\n\t})\n\tconst ended = defineListener({\n\t\tid: 'holds.ended',\n\t\tevent: channelEnded,\n\t\trun(_world, { caster, ability }) {\n\t\t\tconst held = caster.get(aiming)\n\t\t\tif (held && held.held === undefined && held.ability === ability.id && !channelOf(caster, ability.id)) caster.remove(aiming)\n\t\t}\n\t})\n\treturn {\n\t\tid: HOLDS,\n\t\tcomponents: [aiming, walkingChannel],\n\t\tcommands: [releaseCommand, aimCommand],\n\t\tsystems: [holdsSystem],\n\t\thooks: [press, walks],\n\t\tlisteners: [aimed, ended]\n\t}\n}\n"],"mappings":"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"}

package/dist/home.d.ts

@@ -1,5 +1,5 @@
 /**
- * A side's home (`homeOf`): where its heroes come back (`withRespawn`) and are recalled to (an ability's `teleport` to
+ * A side's home (`homeOf`): where its heroes come back (`respawnPack`) and are recalled to (an ability's `teleport` to
  * `home`). Of nothing but the world, so that an ability's effects and the heroes' respawn each read it alone
  */
 import type { PlayerId } from './entity';

package/dist/home.js

@@ -0,0 +1,30 @@
+import { distSq } from "./math.js";
+//#region src/home.ts
+/**
+* A side's home, where its heroes come back and are recalled to: the map's point named `home.<team>` (`home.1`), or
+* else the structure of the player's side nearest `near` (its core, its hall), or else nothing
+*
+* @beta
+*/
+function homeOf(world, player, near) {
+	const name = `home.${world.player(player).team}`;
+	if (world.map.points.some((point) => point.name === name)) return world.map.point(name);
+	let best;
+	let bestDistance = Infinity;
+	for (const entity of world.entities.values()) {
+		if (!entity.alive || !entity.isStructure || !world.areAllies(entity.owner, player)) continue;
+		const d = near ? distSq(entity.pos, near) : entity.id;
+		if (d < bestDistance) {
+			bestDistance = d;
+			best = entity;
+		}
+	}
+	return best && {
+		x: best.pos.x,
+		z: best.pos.z
+	};
+}
+//#endregion
+export { homeOf };
+
+//# sourceMappingURL=home.js.map

package/dist/home.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"home.js","names":[],"sources":["../src/home.ts"],"sourcesContent":["/**\n * A side's home (`homeOf`): where its heroes come back (`respawnPack`) and are recalled to (an ability's `teleport` to\n * `home`). Of nothing but the world, so that an ability's effects and the heroes' respawn each read it alone\n */\nimport type { Entity, PlayerId } from './entity'\nimport { distSq, type Vec2 } from './math'\nimport type { World } from './world'\n\n/**\n * A side's home, where its heroes come back and are recalled to: the map's point named `home.<team>` (`home.1`), or\n * else the structure of the player's side nearest `near` (its core, its hall), or else nothing\n *\n * @beta\n */\nexport function homeOf(world: World, player: PlayerId, near?: Vec2): Vec2 | undefined {\n\tconst team = world.player(player).team\n\tconst name = `home.${team}`\n\tif (world.map.points.some((point) => point.name === name)) return world.map.point(name)\n\tlet best: Entity | undefined\n\tlet bestDistance = Infinity\n\tfor (const entity of world.entities.values()) {\n\t\tif (!entity.alive || !entity.isStructure || !world.areAllies(entity.owner, player)) continue\n\t\tconst d = near ? distSq(entity.pos, near) : entity.id\n\t\tif (d < bestDistance) {\n\t\t\tbestDistance = d\n\t\t\tbest = entity\n\t\t}\n\t}\n\treturn best && { x: best.pos.x, z: best.pos.z }\n}\n"],"mappings":";;;;;;;;AAcA,SAAgB,OAAO,OAAc,QAAkB,MAA+B;CAErF,MAAM,OAAO,QADA,MAAM,OAAO,MAAM,CAAC,CAAC;CAElC,IAAI,MAAM,IAAI,OAAO,MAAM,UAAU,MAAM,SAAS,IAAI,GAAG,OAAO,MAAM,IAAI,MAAM,IAAI;CACtF,IAAI;CACJ,IAAI,eAAe;CACnB,KAAK,MAAM,UAAU,MAAM,SAAS,OAAO,GAAG;EAC7C,IAAI,CAAC,OAAO,SAAS,CAAC,OAAO,eAAe,CAAC,MAAM,UAAU,OAAO,OAAO,MAAM,GAAG;EACpF,MAAM,IAAI,OAAO,OAAO,OAAO,KAAK,IAAI,IAAI,OAAO;EACnD,IAAI,IAAI,cAAc;GACrB,eAAe;GACf,OAAO;EACR;CACD;CACA,OAAO,QAAQ;EAAE,GAAG,KAAK,IAAI;EAAG,GAAG,KAAK,IAAI;CAAE;AAC/C"}