@v12-engine/engine 0.1.0 → 0.4.0

package/dist/abilityChanges.js

@@ -0,0 +1,345 @@
+import { defineComponent } from "./components.js";
+import { defineHook } from "./hooks.js";
+import { valueOf } from "./abilities/amounts.js";
+import { defineEffect, effectTargets } from "./abilities/effects.js";
+import { id, string } from "./fields.js";
+import { defineCommand } from "./commands.js";
+//#region src/abilityChanges.ts
+/**
+* The ability changes pack's id
+*
+* @beta
+*/
+var ABILITY_CHANGES = "core.abilityChanges";
+/**
+* A unit's abilities given for a while (`AbilityGrant`), in the order they were given. Told to its owner
+*
+* @beta
+*/
+var abilityGrants = /* @__PURE__ */ defineComponent({
+	id: "core.abilityGrants",
+	replicate: "owner",
+	index: true,
+	refs: (saved) => ({ abilities: saved.flatMap((grant) => grant.replaced ? [grant.ability, grant.replaced.id] : [grant.ability]) }),
+	snapshot: (grants) => grants.map((grant) => ({
+		ability: grant.ability,
+		...grant.left !== void 0 && { left: Math.ceil(grant.left) },
+		...grant.uses !== void 0 && { uses: grant.uses },
+		...grant.replaced && { replaces: grant.replaced.id }
+	}))
+});
+/**
+* Whose a unit made someone else's for a while was (`Converted`)
+*
+* @beta
+*/
+var converted = /* @__PURE__ */ defineComponent({
+	id: "core.converted",
+	index: true
+});
+/** The state of an ability as a unit is first given it */
+var fresh = (world, ability, level) => ({
+	id: ability,
+	level,
+	cooldown: 0,
+	autocast: world.registry.ability(ability).autocast ?? false
+});
+/** Keeps how long a change lasts, where it does not last for good */
+function keep(entity, grant) {
+	if (grant.left === void 0 && grant.uses === void 0 && !grant.replaced) return;
+	entity.set(abilityGrants, [...(entity.get(abilityGrants) ?? []).filter((each) => each.ability !== grant.ability), grant]);
+}
+/** The record of a change that lasts a while, of an ability a unit has */
+var grantOf = (entity, ability) => entity.get(abilityGrants)?.find((grant) => grant.ability === ability);
+/** Takes a change's record off */
+function forget(entity, ability) {
+	const left = (entity.get(abilityGrants) ?? []).filter((grant) => grant.ability !== ability);
+	if (left.length) entity.set(abilityGrants, left);
+	else entity.remove(abilityGrants);
+}
+/**
+* Gives a unit an ability it has not (`GrantOptions`: at a level, for a while or so many casts, at a place on its card).
+* What lasts a while needs the ability changes pack (`abilityChangesPack`) to end; for good, it does not. False where
+* the ability is none or the unit has it already
+*
+* @beta
+*/
+function grantAbility(world, entity, ability, options = {}) {
+	if (!world.registry.abilities.has(ability) || entity.abilities.some((each) => each.id === ability)) return false;
+	const list = [...entity.abilities];
+	const slot = Math.min(Math.max(options.slot ?? list.length, 0), list.length);
+	list.splice(slot, 0, fresh(world, ability, options.level ?? 1));
+	entity.setAbilities(list);
+	keep(entity, {
+		ability,
+		...options.until !== void 0 && { left: options.until },
+		...options.uses !== void 0 && { uses: options.uses }
+	});
+	return true;
+}
+/**
+* Takes an ability off a unit; what it took the place of, where it was given in place of another for a while, is back
+* there. False where it had none
+*
+* @beta
+*/
+function removeAbility(world, entity, ability) {
+	const at = entity.abilities.findIndex((each) => each.id === ability);
+	if (at < 0) return false;
+	const grant = grantOf(entity, ability);
+	forget(entity, ability);
+	const list = [...entity.abilities];
+	if (grant?.replaced && world.registry.abilities.has(grant.replaced.id)) list[at] = grant.replaced;
+	else list.splice(at, 1);
+	entity.setAbilities(list);
+	return true;
+}
+/**
+* Puts an ability in the place of another of a unit's (`from`), at its level (or `options.level`): for good, or for a
+* while or so many casts (`until`, `uses`: then `from` is back, its cooldown having run on). A stance, an awakened
+* ability, a weapon of a set. False where it has no `from`, the new one is none or it has it already
+*
+* @beta
+*/
+function swapAbility(world, entity, from, to, options = {}) {
+	const at = entity.abilities.findIndex((each) => each.id === from);
+	if (at < 0 || !world.registry.abilities.has(to) || entity.abilities.some((each) => each.id === to)) return false;
+	const old = entity.abilities[at];
+	const before = grantOf(entity, from);
+	forget(entity, from);
+	const list = [...entity.abilities];
+	list[at] = fresh(world, to, options.level ?? old.level);
+	entity.setAbilities(list);
+	if (options.until !== void 0 || options.uses !== void 0) keep(entity, {
+		ability: to,
+		...options.until !== void 0 && { left: options.until },
+		...options.uses !== void 0 && { uses: options.uses },
+		replaced: before?.replaced ?? old
+	});
+	else if (before?.replaced) keep(entity, {
+		...before,
+		ability: to
+	});
+	return true;
+}
+/**
+* Makes an ability of a unit's into one it may become (`AbilityDef.upgrades`), for good: at its level, with its cooldown.
+* False where it has no such ability or that is not one it may become
+*
+* @beta
+*/
+function upgradeAbility(world, entity, from, to) {
+	const state = entity.abilities.find((each) => each.id === from);
+	if (!state || !world.registry.abilities.has(from) || !world.registry.ability(from).upgrades?.includes(to)) return false;
+	const cooldown = state.cooldown;
+	if (!swapAbility(world, entity, from, to)) return false;
+	entity.abilities.find((each) => each.id === to).cooldown = cooldown;
+	return true;
+}
+/** What a change that lasted a while leaves as it ends: what it took the place of back, or nothing */
+function end(world, entity, grant) {
+	if (entity.abilities.some((each) => each.id === grant.ability)) removeAbility(world, entity, grant.ability);
+	else forget(entity, grant.ability);
+}
+/** Which of a unit's abilities a steal takes (`EffectFields.pick`) */
+function picked(world, victim, pick) {
+	const castable = victim.abilities.filter((state) => state.level >= 1 && world.registry.abilities.has(state.id) && world.registry.ability(state.id).target !== "passive");
+	if (pick === "first") return castable[0];
+	if (pick === "random") return castable.length ? castable[world.rng.int(0, castable.length - 1)] : void 0;
+	return castable.find((state) => world.registry.ability(state.id).ultimate);
+}
+var grantEffect = /* @__PURE__ */ defineEffect({
+	type: "grantAbility",
+	run: (context, effect) => {
+		const until = effect.duration === void 0 ? void 0 : valueOf(context, effect.duration);
+		for (const entity of effectTargets(context, effect, "allies")) if (entity.isUnit) grantAbility(context.world, entity, effect.ability, {
+			level: effect.atLevel ?? context.level,
+			until,
+			uses: effect.uses
+		});
+	},
+	fields: [
+		{
+			path: "ability",
+			kind: "id",
+			of: "abilities",
+			hint: "The ability given"
+		},
+		{
+			path: "atLevel",
+			kind: "integer",
+			min: 1,
+			hint: "The level it is given at: the effect’s own when left out"
+		},
+		"duration",
+		{
+			path: "uses",
+			kind: "integer",
+			min: 1,
+			hint: "Casts of it before it is gone: for good with neither this nor a duration"
+		}
+	]
+});
+var swapEffect = /* @__PURE__ */ defineEffect({
+	type: "swapAbility",
+	run: (context, effect) => {
+		const until = effect.duration === void 0 ? void 0 : valueOf(context, effect.duration);
+		swapAbility(context.world, context.caster, effect.from ?? context.ability.id, effect.ability, {
+			level: effect.atLevel,
+			until,
+			uses: effect.uses
+		});
+	},
+	fields: [
+		{
+			path: "ability",
+			kind: "id",
+			of: "abilities",
+			hint: "The ability that takes the other’s place"
+		},
+		{
+			path: "from",
+			kind: "id",
+			of: "abilities",
+			hint: "The caster’s ability that gives way: the one the effect belongs to when left out"
+		},
+		{
+			path: "atLevel",
+			kind: "integer",
+			min: 1,
+			hint: "The level it is given at: that of the one it takes the place of when left out"
+		},
+		"duration",
+		{
+			path: "uses",
+			kind: "integer",
+			min: 1,
+			hint: "Casts of it before the other is back: for good with neither this nor a duration"
+		}
+	]
+});
+var stealEffect = /* @__PURE__ */ defineEffect({
+	type: "stealAbility",
+	run: (context, effect) => {
+		const { world, caster, target, ability, level } = context;
+		if (!target?.alive || target === caster) return;
+		const stolen = picked(world, target, effect.pick ?? "ultimate");
+		if (!stolen) return;
+		const until = effect.duration === void 0 ? void 0 : valueOf(context, effect.duration);
+		swapAbility(world, caster, ability.id, stolen.id, {
+			level,
+			until,
+			uses: effect.uses ?? (until === void 0 ? 1 : void 0)
+		});
+	},
+	fields: [
+		{
+			path: "pick",
+			options: [
+				"ultimate",
+				"first",
+				"random"
+			],
+			hint: "Which of the target’s abilities it takes: its ultimate when left out"
+		},
+		"duration",
+		{
+			path: "uses",
+			kind: "integer",
+			min: 1,
+			hint: "Casts of it before it is given back: one when left out"
+		}
+	]
+});
+var convertEffect = /* @__PURE__ */ defineEffect({
+	type: "convert",
+	run: (context, effect) => {
+		const { world, caster } = context;
+		const until = effect.duration === void 0 ? void 0 : valueOf(context, effect.duration);
+		for (const entity of effectTargets(context, effect, "enemies")) {
+			if (!entity.isUnit || entity.def.hero || entity.owner === caster.owner) continue;
+			const was = entity.get(converted)?.owner ?? entity.owner;
+			world.setOwner(entity, caster.owner);
+			if (until !== void 0) entity.set(converted, {
+				owner: was,
+				left: until
+			});
+			else entity.remove(converted);
+		}
+	},
+	fields: ["duration"]
+});
+/** Changes that last a while running out, what they took the place of cooling down meanwhile; units made another's given back */
+var changesSystem = {
+	name: "abilityChanges",
+	phase: "decide",
+	after: ["abilities"],
+	update(world, dt) {
+		for (const entity of [...world.index.with(abilityGrants)]) for (const grant of [...entity.get(abilityGrants) ?? []]) {
+			if (grant.replaced) grant.replaced.cooldown = Math.max(grant.replaced.cooldown - dt, 0);
+			if (grant.left === void 0) continue;
+			grant.left -= dt;
+			if (grant.left <= 0) end(world, entity, grant);
+		}
+		for (const entity of [...world.index.with(converted)]) {
+			const was = entity.get(converted);
+			was.left -= dt;
+			if (was.left > 0 && entity.alive) continue;
+			entity.remove(converted);
+			if (entity.alive) world.setOwner(entity, was.owner);
+		}
+	}
+};
+/**
+* Makes one of a unit's abilities into one it may become (`upgradeAbility`): Viktor's augment chosen
+*
+* @beta
+*/
+var upgradeAbilityCommand = /* @__PURE__ */ defineCommand("upgradeAbility", {
+	entity: id,
+	ability: string,
+	into: string
+}, (world, player, command) => {
+	const entity = world.get(command.entity);
+	if (entity?.alive && world.mayCommand(player, entity)) upgradeAbility(world, entity, command.ability, command.into);
+});
+/**
+* Abilities changed at runtime: what a game with it (`Rules.packs`) gets. The effects `grantAbility` (an ability given,
+* for a while or so many casts), `swapAbility` (one in the place of another on the card, and back), `stealAbility` (the
+* target's ultimate in the place of the one cast, for one cast: Hijack) and `convert` (the target the caster's: Charm);
+* an ability's `upgrades`, one chosen for good (the `upgradeAbility` command); what lasts a while kept in the
+* `abilityGrants` component, told to the owner (a stolen one shown in the place of what it took). `grantAbility`,
+* `removeAbility`, `swapAbility` and `upgradeAbility` in code
+*
+* @beta
+*/
+function abilityChangesPack() {
+	const used = defineHook({
+		hook: "afterCast",
+		id: "abilityChanges",
+		run(world, event) {
+			if (event.item) return;
+			const grant = grantOf(event.caster, event.ability.id);
+			if (grant?.uses === void 0) return;
+			grant.uses--;
+			if (grant.uses <= 0) end(world, event.caster, grant);
+		}
+	});
+	return {
+		id: ABILITY_CHANGES,
+		components: [abilityGrants, converted],
+		effects: [
+			grantEffect,
+			swapEffect,
+			stealEffect,
+			convertEffect
+		],
+		commands: [upgradeAbilityCommand],
+		systems: [changesSystem],
+		hooks: [used]
+	};
+}
+//#endregion
+export { ABILITY_CHANGES, abilityChangesPack, abilityGrants, converted, grantAbility, removeAbility, swapAbility, upgradeAbility, upgradeAbilityCommand };
+
+//# sourceMappingURL=abilityChanges.js.map

package/dist/abilityChanges.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"abilityChanges.js","names":[],"sources":["../src/abilityChanges.ts"],"sourcesContent":["import { defineEffect, effectTargets } from './abilities/effects'\nimport { valueOf } from './abilities/amounts'\nimport { defineCommand } from './commands'\nimport { defineComponent } from './components'\nimport type { AbilityState, Entity, PlayerId } from './entity'\nimport { id, string } from './fields'\nimport { defineHook } from './hooks'\nimport type { GamePack } from './packs/pack'\nimport type { System } from './registry'\nimport type { World } from './world'\n\n/*\n * Abilities changed at runtime, an opt-in pack (E2E-PLAN AB16): an ability given for a while or so many casts, one\n * giving way to another in its place (a stance, an awakened ability), one taken from another unit (Sylas's Hijack), one\n * made into a better one for good (Viktor's augments), and a unit made the caster's (Charm). A game without it pays\n * nothing for these\n */\n\n/**\n * The ability changes pack's id\n *\n * @beta\n */\nexport const ABILITY_CHANGES = 'core.abilityChanges'\n\n/**\n * An ability a unit was given for a while (`grantAbility`, `swapAbility`, a stolen one): seconds `left`, casts left\n * (`uses`), and what it took the place of (`replaced`), back as it is gone\n *\n * @beta\n */\nexport interface AbilityGrant {\n\t/** The ability given */\n\tability: string\n\t/** Seconds until it is gone, where it is for a time */\n\tleft?: number\n\t/** Casts of it before it is gone, where it is for so many */\n\tuses?: number\n\t/** The ability it took the place of, as it was (its cooldown running on meanwhile): back in its place as this goes */\n\treplaced?: AbilityState\n}\n\n/**\n * What a unit's owner is told of its abilities given for a while (`AbilityGrant`): which, for how long, how many casts,\n * and in place of which\n *\n * @beta\n */\nexport interface GrantSent {\n\t/** The ability given */\n\tability: string\n\t/** Seconds until it is gone */\n\tleft?: number\n\t/** Casts of it before it is gone */\n\tuses?: number\n\t/** The ability it took the place of, by id */\n\treplaces?: string\n}\n\n/**\n * A unit's abilities given for a while (`AbilityGrant`), in the order they were given. Told to its owner\n *\n * @beta\n */\nexport const abilityGrants = /* @__PURE__ */ defineComponent<AbilityGrant[], GrantSent[]>({\n\tid: 'core.abilityGrants',\n\treplicate: 'owner',\n\tindex: true,\n\trefs: (saved) => ({ abilities: (saved as AbilityGrant[]).flatMap((grant) => (grant.replaced ? [grant.ability, grant.replaced.id] : [grant.ability])) }),\n\tsnapshot: (grants) =>\n\t\tgrants.map((grant) => ({\n\t\t\tability: grant.ability,\n\t\t\t...(grant.left !== undefined && { left: Math.ceil(grant.left) }),\n\t\t\t...(grant.uses !== undefined && { uses: grant.uses }),\n\t\t\t...(grant.replaced && { replaces: grant.replaced.id })\n\t\t}))\n})\n\n/**\n * Whose a unit made someone else's for a while (`convert` with a `duration`) was, and for how much longer\n *\n * @beta\n */\nexport interface Converted {\n\t/** Whose it was, and is again as the time is up */\n\towner: PlayerId\n\t/** Seconds left */\n\tleft: number\n}\n\n/**\n * Whose a unit made someone else's for a while was (`Converted`)\n *\n * @beta\n */\nexport const converted = /* @__PURE__ */ defineComponent<Converted>({ id: 'core.converted', index: true })\n\n/**\n * Options of a change of a unit's abilities (`grantAbility`, `swapAbility`): its level, for how long or how many casts,\n * where on the card\n *\n * @beta\n */\nexport interface GrantOptions {\n\t/** The level it is given at: 1, or that of what it takes the place of, when left out */\n\tlevel?: number\n\t/** Seconds until it is gone (and what it took the place of back): for good when left out */\n\tuntil?: number\n\t/** Casts of it before it is gone: for good when left out */\n\tuses?: number\n\t/** Where among its abilities (and so on the card) it goes: after the rest when left out */\n\tslot?: number\n}\n\n/** The state of an ability as a unit is first given it */\nconst fresh = (world: World, ability: string, level: number): AbilityState => ({\n\tid: ability,\n\tlevel,\n\tcooldown: 0,\n\tautocast: world.registry.ability(ability).autocast ?? false\n})\n\n/** Keeps how long a change lasts, where it does not last for good */\nfunction keep(entity: Entity, grant: AbilityGrant): void {\n\tif (grant.left === undefined && grant.uses === undefined && !grant.replaced) return\n\tentity.set(abilityGrants, [...(entity.get(abilityGrants) ?? []).filter((each) => each.ability !== grant.ability), grant])\n}\n\n/** The record of a change that lasts a while, of an ability a unit has */\nconst grantOf = (entity: Entity, ability: string) => entity.get(abilityGrants)?.find((grant) => grant.ability === ability)\n\n/** Takes a change's record off */\nfunction forget(entity: Entity, ability: string): void {\n\tconst left = (entity.get(abilityGrants) ?? []).filter((grant) => grant.ability !== ability)\n\tif (left.length) entity.set(abilityGrants, left)\n\telse entity.remove(abilityGrants)\n}\n\n/**\n * Gives a unit an ability it has not (`GrantOptions`: at a level, for a while or so many casts, at a place on its card).\n * What lasts a while needs the ability changes pack (`abilityChangesPack`) to end; for good, it does not. False where\n * the ability is none or the unit has it already\n *\n * @beta\n */\nexport function grantAbility(world: World, entity: Entity, ability: string, options: GrantOptions = {}): boolean {\n\tif (!world.registry.abilities.has(ability) || entity.abilities.some((each) => each.id === ability)) return false\n\tconst list = [...entity.abilities]\n\tconst slot = Math.min(Math.max(options.slot ?? list.length, 0), list.length)\n\tlist.splice(slot, 0, fresh(world, ability, options.level ?? 1))\n\tentity.setAbilities(list)\n\tkeep(entity, { ability, ...(options.until !== undefined && { left: options.until }), ...(options.uses !== undefined && { uses: options.uses }) })\n\treturn true\n}\n\n/**\n * Takes an ability off a unit; what it took the place of, where it was given in place of another for a while, is back\n * there. False where it had none\n *\n * @beta\n */\nexport function removeAbility(world: World, entity: Entity, ability: string): boolean {\n\tconst at = entity.abilities.findIndex((each) => each.id === ability)\n\tif (at < 0) return false\n\tconst grant = grantOf(entity, ability)\n\tforget(entity, ability)\n\tconst list = [...entity.abilities]\n\tif (grant?.replaced && world.registry.abilities.has(grant.replaced.id)) list[at] = grant.replaced\n\telse list.splice(at, 1)\n\tentity.setAbilities(list)\n\treturn true\n}\n\n/**\n * Puts an ability in the place of another of a unit's (`from`), at its level (or `options.level`): for good, or for a\n * while or so many casts (`until`, `uses`: then `from` is back, its cooldown having run on). A stance, an awakened\n * ability, a weapon of a set. False where it has no `from`, the new one is none or it has it already\n *\n * @beta\n */\nexport function swapAbility(world: World, entity: Entity, from: string, to: string, options: Omit<GrantOptions, 'slot'> = {}): boolean {\n\tconst at = entity.abilities.findIndex((each) => each.id === from)\n\tif (at < 0 || !world.registry.abilities.has(to) || entity.abilities.some((each) => each.id === to)) return false\n\tconst old = entity.abilities[at]\n\t// given back to what it took the place of, where it was itself in the place of another: that one in the end\n\tconst before = grantOf(entity, from)\n\tforget(entity, from)\n\tconst list = [...entity.abilities]\n\tlist[at] = fresh(world, to, options.level ?? old.level)\n\tentity.setAbilities(list)\n\tconst lasts = options.until !== undefined || options.uses !== undefined\n\tif (lasts)\n\t\tkeep(entity, {\n\t\t\tability: to,\n\t\t\t...(options.until !== undefined && { left: options.until }),\n\t\t\t...(options.uses !== undefined && { uses: options.uses }),\n\t\t\treplaced: before?.replaced ?? old\n\t\t})\n\telse if (before?.replaced) keep(entity, { ...before, ability: to })\n\treturn true\n}\n\n/**\n * Makes an ability of a unit's into one it may become (`AbilityDef.upgrades`), for good: at its level, with its cooldown.\n * False where it has no such ability or that is not one it may become\n *\n * @beta\n */\nexport function upgradeAbility(world: World, entity: Entity, from: string, to: string): boolean {\n\tconst state = entity.abilities.find((each) => each.id === from)\n\tif (!state || !world.registry.abilities.has(from) || !world.registry.ability(from).upgrades?.includes(to)) return false\n\tconst cooldown = state.cooldown\n\tif (!swapAbility(world, entity, from, to)) return false\n\tentity.abilities.find((each) => each.id === to)!.cooldown = cooldown\n\treturn true\n}\n\n/** What a change that lasted a while leaves as it ends: what it took the place of back, or nothing */\nfunction end(world: World, entity: Entity, grant: AbilityGrant): void {\n\tif (entity.abilities.some((each) => each.id === grant.ability)) removeAbility(world, entity, grant.ability)\n\telse forget(entity, grant.ability)\n}\n\n/** Which of a unit's abilities a steal takes (`EffectFields.pick`) */\nfunction picked(world: World, victim: Entity, pick: 'ultimate' | 'first' | 'random'): AbilityState | undefined {\n\tconst castable = victim.abilities.filter(\n\t\t(state) => state.level >= 1 && world.registry.abilities.has(state.id) && world.registry.ability(state.id).target !== 'passive'\n\t)\n\tif (pick === 'first') return castable[0]\n\tif (pick === 'random') return castable.length ? castable[world.rng.int(0, castable.length - 1)] : undefined\n\treturn castable.find((state) => world.registry.ability(state.id).ultimate)\n}\n\nconst grantEffect = /* @__PURE__ */ defineEffect({\n\ttype: 'grantAbility',\n\trun: (context, effect) => {\n\t\tconst until = effect.duration === undefined ? undefined : valueOf(context, effect.duration)\n\t\tfor (const entity of effectTargets(context, effect, 'allies'))\n\t\t\tif (entity.isUnit) grantAbility(context.world, entity, effect.ability, { level: effect.atLevel ?? context.level, until, uses: effect.uses })\n\t},\n\tfields: [\n\t\t{ path: 'ability', kind: 'id', of: 'abilities', hint: 'The ability given' },\n\t\t{ path: 'atLevel', kind: 'integer', min: 1, hint: 'The level it is given at: the effect’s own when left out' },\n\t\t'duration',\n\t\t{ path: 'uses', kind: 'integer', min: 1, hint: 'Casts of it before it is gone: for good with neither this nor a duration' }\n\t]\n})\n\nconst swapEffect = /* @__PURE__ */ defineEffect({\n\ttype: 'swapAbility',\n\trun: (context, effect) => {\n\t\tconst until = effect.duration === undefined ? undefined : valueOf(context, effect.duration)\n\t\tswapAbility(context.world, context.caster, effect.from ?? context.ability.id, effect.ability, { level: effect.atLevel, until, uses: effect.uses })\n\t},\n\tfields: [\n\t\t{ path: 'ability', kind: 'id', of: 'abilities', hint: 'The ability that takes the other’s place' },\n\t\t{ path: 'from', kind: 'id', of: 'abilities', hint: 'The caster’s ability that gives way: the one the effect belongs to when left out' },\n\t\t{ path: 'atLevel', kind: 'integer', min: 1, hint: 'The level it is given at: that of the one it takes the place of when left out' },\n\t\t'duration',\n\t\t{ path: 'uses', kind: 'integer', min: 1, hint: 'Casts of it before the other is back: for good with neither this nor a duration' }\n\t]\n})\n\nconst stealEffect = /* @__PURE__ */ defineEffect({\n\ttype: 'stealAbility',\n\trun: (context, effect) => {\n\t\tconst { world, caster, target, ability, level } = context\n\t\tif (!target?.alive || target === caster) return\n\t\tconst stolen = picked(world, target, effect.pick ?? 'ultimate')\n\t\tif (!stolen) return\n\t\tconst until = effect.duration === undefined ? undefined : valueOf(context, effect.duration)\n\t\tswapAbility(world, caster, ability.id, stolen.id, { level, until, uses: effect.uses ?? (until === undefined ? 1 : undefined) })\n\t},\n\tfields: [\n\t\t{ path: 'pick', options: ['ultimate', 'first', 'random'], hint: 'Which of the target’s abilities it takes: its ultimate when left out' },\n\t\t'duration',\n\t\t{ path: 'uses', kind: 'integer', min: 1, hint: 'Casts of it before it is given back: one when left out' }\n\t]\n})\n\nconst convertEffect = /* @__PURE__ */ defineEffect({\n\ttype: 'convert',\n\trun: (context, effect) => {\n\t\tconst { world, caster } = context\n\t\tconst until = effect.duration === undefined ? undefined : valueOf(context, effect.duration)\n\t\tfor (const entity of effectTargets(context, effect, 'enemies')) {\n\t\t\tif (!entity.isUnit || entity.def.hero || entity.owner === caster.owner) continue\n\t\t\tconst was = entity.get(converted)?.owner ?? entity.owner\n\t\t\tworld.setOwner(entity, caster.owner)\n\t\t\tif (until !== undefined) entity.set(converted, { owner: was, left: until })\n\t\t\telse entity.remove(converted)\n\t\t}\n\t},\n\tfields: ['duration']\n})\n\n/** Changes that last a while running out, what they took the place of cooling down meanwhile; units made another's given back */\nconst changesSystem: System = {\n\tname: 'abilityChanges',\n\tphase: 'decide',\n\tafter: ['abilities'],\n\tupdate(world, dt) {\n\t\tfor (const entity of [...world.index.with(abilityGrants)]) {\n\t\t\tfor (const grant of [...(entity.get(abilityGrants) ?? [])]) {\n\t\t\t\tif (grant.replaced) grant.replaced.cooldown = Math.max(grant.replaced.cooldown - dt, 0)\n\t\t\t\tif (grant.left === undefined) continue\n\t\t\t\tgrant.left -= dt\n\t\t\t\tif (grant.left <= 0) end(world, entity, grant)\n\t\t\t}\n\t\t}\n\t\tfor (const entity of [...world.index.with(converted)]) {\n\t\t\tconst was = entity.get(converted)!\n\t\t\twas.left -= dt\n\t\t\tif (was.left > 0 && entity.alive) continue\n\t\t\tentity.remove(converted)\n\t\t\tif (entity.alive) world.setOwner(entity, was.owner)\n\t\t}\n\t}\n}\n\n/**\n * Makes one of a unit's abilities into one it may become (`upgradeAbility`): Viktor's augment chosen\n *\n * @beta\n */\nexport const upgradeAbilityCommand = /* @__PURE__ */ defineCommand('upgradeAbility', { entity: id, ability: string, into: string }, (world, player, command) => {\n\tconst entity = world.get(command.entity)\n\tif (entity?.alive && world.mayCommand(player, entity)) upgradeAbility(world, entity, command.ability, command.into)\n})\n\n/**\n * Abilities changed at runtime: what a game with it (`Rules.packs`) gets. The effects `grantAbility` (an ability given,\n * for a while or so many casts), `swapAbility` (one in the place of another on the card, and back), `stealAbility` (the\n * target's ultimate in the place of the one cast, for one cast: Hijack) and `convert` (the target the caster's: Charm);\n * an ability's `upgrades`, one chosen for good (the `upgradeAbility` command); what lasts a while kept in the\n * `abilityGrants` component, told to the owner (a stolen one shown in the place of what it took). `grantAbility`,\n * `removeAbility`, `swapAbility` and `upgradeAbility` in code\n *\n * @beta\n */\nexport function abilityChangesPack(): GamePack {\n\t// cast so many times: gone, and what it took the place of back\n\tconst used = defineHook({\n\t\thook: 'afterCast',\n\t\tid: 'abilityChanges',\n\t\trun(world, event) {\n\t\t\tif (event.item) return\n\t\t\tconst grant = grantOf(event.caster, event.ability.id)\n\t\t\tif (grant?.uses === undefined) return\n\t\t\tgrant.uses--\n\t\t\tif (grant.uses <= 0) end(world, event.caster, grant)\n\t\t}\n\t})\n\treturn {\n\t\tid: ABILITY_CHANGES,\n\t\tcomponents: [abilityGrants, converted],\n\t\teffects: [grantEffect, swapEffect, stealEffect, convertEffect],\n\t\tcommands: [upgradeAbilityCommand],\n\t\tsystems: [changesSystem],\n\t\thooks: [used]\n\t}\n}\n"],"mappings":"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"}

package/dist/ai/area.d.ts

@@ -41,7 +41,10 @@ export interface AreaKey<T extends AiArea> {
  *
  * @beta
  */
-export declare function defineArea<T extends AiArea>(id: string, make: (ai: Brain) => T): AreaKey<T>;
+export declare function defineArea<T extends AiArea>(def: {
+    id: string;
+    make: (ai: Brain) => T;
+}): AreaKey<T>;
 /**
  * What a brain's areas remember, by id (`BrainMemory.areas`): each area of the kit adds its own here, as a game's own may
  * (`declare module '@v12-engine/engine/ai' { interface AreaMemories { 'mygame.diplomacy'?: DiplomacyMemory } }`)

package/dist/ai/brain.d.ts

@@ -24,7 +24,7 @@ import type { ThreatMap } from './threat';
 import { AiView } from './view';
 /**
  * What a computer player is made of, defined once (`defineBrain`) and seated as often as wanted
- * (`world.computers.seat`). A game lists the brains it seats in `GameModule.brains`, so that a save that remembers a
+ * (`world.computers.seat`). A game lists the brains it seats in `Rules.brains`, so that a save that remembers a
  * seat by its brain's id finds it again when loaded
  *
  * @beta
@@ -333,6 +333,8 @@ export declare class Brain implements ComputerPlayer {
     private lastThink;
     /** The last order each unit was sent, with the tick: what an order sent again for the same thing is counted against (`AiStats.churn`) */
     private readonly lastOrders;
+    /** The tick each unit was last told to cast: an order told again after a cast between is not counted as churn */
+    private readonly castAt;
     /**
      * How much of a think one tick may do (`ThinkBudget`): so many modules, so many units looked at as the modules say
      * (`budget.spent(n)`), the think going on at the next tick from where it stopped (`budget.later()`). Counted in work,
@@ -418,6 +420,7 @@ export declare class Brain implements ComputerPlayer {
     get me(): PlayerState | undefined;
     /** A module of its, by key with its shape (`MELEE_ARMY`, `moduleKey`), or by id */
     module<M extends AiModule>(key: ModuleKey<M>): M | undefined;
+    /** Finds one of the brain's modules by id, or nothing when it has none of that id */
     module(id: string): AiModule | undefined;
     /**
      * What its areas play by this think (`AiSettings`): its settings' layers worked out, a flag that is a function of the