@v12-engine/engine 0.1.1 → 0.4.0

package/dist/packs/heroes/carry.js

@@ -0,0 +1,112 @@
+import { slotsOf } from "../../inventory.js";
+import { refreshVitals } from "../../stats.js";
+import { inventoryChanged } from "../../engineEvents.js";
+import { readyAgain } from "../../abilities/charges.js";
+import { heroOf, maxLevelOf } from "../../hero.js";
+import { createItem } from "../../items.js";
+//#region src/packs/heroes/carry.ts
+/**
+* A hero of a world as a record, to carry into another (see `applyHeroRecord`). Throws for what is no hero
+*
+* @beta
+*/
+function heroRecord(world, hero) {
+	const state = heroOf(hero);
+	if (!state) throw new Error(`${hero.def.id} is no hero to carry over`);
+	const name = world.nameOf(hero);
+	return {
+		type: hero.def.id,
+		...name !== void 0 && { name },
+		level: state.level,
+		xp: state.xp,
+		points: state.points,
+		abilities: Object.fromEntries(hero.abilities.filter((ability) => ability.level > 0).map((ability) => [ability.id, ability.level])),
+		items: (slotsOf(hero) ?? []).map((slot) => slot ? {
+			item: slot.item,
+			charges: slot.charges,
+			...slot.data && { data: structuredClone(slot.data) }
+		} : null)
+	};
+}
+/**
+* Makes a hero of a world what a record says it was: its level, experience and points, its abilities as far as they
+* were learned, and its items in their slots. In place of what it had. What the game no longer has, an ability or an
+* item, is left out. Whole: health and mana full, nothing cooling down
+*
+* @beta
+*/
+function applyHeroRecord(world, hero, record) {
+	const state = heroOf(hero);
+	if (!state) throw new Error(`${hero.def.id} is no hero to carry a hero into`);
+	state.level = Math.max(1, Math.min(Math.floor(record.level), maxLevelOf(world, hero)));
+	state.xp = Math.max(record.xp, world.settings.heroes.xpForLevel(state.level));
+	state.points = Math.max(Math.floor(record.points), 0);
+	for (const ability of hero.abilities) {
+		const level = record.abilities[ability.id] ?? 0;
+		const max = world.registry.abilities.has(ability.id) ? world.registry.ability(ability.id).maxLevel ?? 3 : 0;
+		ability.level = Math.min(level, max);
+		readyAgain(ability);
+		ability.autocast = ability.level > 0 && (world.registry.ability(ability.id).autocast ?? false);
+	}
+	const slots = slotsOf(hero);
+	if (slots) {
+		slots.fill(null);
+		record.items.forEach((carried, slot) => {
+			if (!carried || slot >= slots.length || !world.registry.items.has(carried.item)) return;
+			const instance = createItem(world, carried.item, carried.charges);
+			if (carried.data) instance.data = structuredClone(carried.data);
+			slots[slot] = instance;
+		});
+		world.events.emit(inventoryChanged, { entity: hero });
+	}
+	refreshVitals(world, hero);
+	hero.health = hero.maxHealth;
+	hero.mana = hero.maxMana;
+}
+/**
+* A hero made from a record (see `heroRecord`) for a player at a point, under the name it had unless told another
+*
+* @beta
+*/
+function heroFromRecord(world, record, owner, at, options = {}) {
+	const name = options.name ?? record.name;
+	const hero = world.spawn(record.type, owner, at, {
+		...options,
+		...name !== void 0 && { name }
+	});
+	applyHeroRecord(world, hero, record);
+	return hero;
+}
+/**
+* A record read back from what was kept (a campaign's progress, a file), checked. Throws on what is wrong
+*
+* @beta
+*/
+function readHeroRecord(data) {
+	const record = data;
+	if (typeof record !== "object" || record === null) throw new Error("A hero record is an object");
+	if (typeof record.type !== "string" || !record.type) throw new Error("A hero record says what type of unit it is");
+	const number = (value, what) => {
+		if (typeof value !== "number" || !Number.isFinite(value)) throw new Error(`A hero record's ${what} is a number`);
+		return value;
+	};
+	const abilities = record.abilities ?? {};
+	if (typeof abilities !== "object" || Array.isArray(abilities)) throw new Error("A hero record's abilities are levels by id");
+	return {
+		type: record.type,
+		...typeof record.name === "string" && { name: record.name },
+		level: number(record.level, "level"),
+		xp: number(record.xp ?? 0, "experience"),
+		points: number(record.points ?? 0, "points"),
+		abilities: Object.fromEntries(Object.entries(abilities).map(([id, level]) => [id, number(level, `level of ${id}`)])),
+		items: (Array.isArray(record.items) ? record.items : []).map((slot) => slot && typeof slot === "object" && typeof slot.item === "string" ? {
+			item: slot.item,
+			charges: number(slot.charges ?? 0, "charges"),
+			...slot.data && { data: slot.data }
+		} : null)
+	};
+}
+//#endregion
+export { applyHeroRecord, heroFromRecord, heroRecord, readHeroRecord };
+
+//# sourceMappingURL=carry.js.map

package/dist/packs/heroes/carry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"carry.js","names":[],"sources":["../../../src/packs/heroes/carry.ts"],"sourcesContent":["import { inventoryChanged } from '#engine/engineEvents'\nimport type { Entity, PlayerId } from '#engine/entity'\nimport { createItem } from '#engine/items'\nimport { slotsOf } from '#engine/inventory'\nimport { heroOf, maxLevelOf } from '#engine/hero'\nimport { refreshVitals } from '#engine/stats'\nimport { readyAgain } from '#engine/abilities/charges'\nimport type { Vec2 } from '#engine/math'\nimport type { SpawnOptions, World } from '#engine/world'\n\n/**\n * An item a hero carries, as it is carried over: what it is, its uses left, the game's own state of it\n *\n * @beta\n */\nexport interface HeroItem {\n\t/** The id of the item type carried */\n\titem: string\n\t/** Uses left of the item */\n\tcharges: number\n\t/** The game's own state of the item, carried over as plain data */\n\tdata?: Record<string, unknown>\n}\n\n/**\n * A hero as plain data, to take from one world into another: a campaign's hero going on to the next mission with all\n * it has earned. Its level and experience, the points it has not spent, the abilities it learned and how far, and its\n * items slot by slot. Not where it is or how hurt: the next mission puts it where it starts, whole\n *\n * @beta\n */\nexport interface HeroRecord {\n\t/** Its unit type */\n\ttype: string\n\t/** The name it was known by in the rules (`world.named`), when it had one */\n\tname?: string\n\t/** The hero's level */\n\tlevel: number\n\t/** The hero's experience points */\n\txp: number\n\t/** Skill points the hero has earned and not yet spent */\n\tpoints: number\n\t/** Learned abilities and their level. Ones not learned are left out */\n\tabilities: Record<string, number>\n\t/** Its inventory slot by slot: null for an empty slot */\n\titems: (HeroItem | null)[]\n}\n\n/**\n * A hero of a world as a record, to carry into another (see `applyHeroRecord`). Throws for what is no hero\n *\n * @beta\n */\nexport function heroRecord(world: World, hero: Entity): HeroRecord {\n\tconst state = heroOf(hero)\n\tif (!state) throw new Error(`${hero.def.id} is no hero to carry over`)\n\tconst name = world.nameOf(hero)\n\treturn {\n\t\ttype: hero.def.id,\n\t\t...(name !== undefined && { name }),\n\t\tlevel: state.level,\n\t\txp: state.xp,\n\t\tpoints: state.points,\n\t\tabilities: Object.fromEntries(hero.abilities.filter((ability) => ability.level > 0).map((ability) => [ability.id, ability.level])),\n\t\titems: (slotsOf(hero) ?? []).map((slot) =>\n\t\t\tslot ? { item: slot.item, charges: slot.charges, ...(slot.data && { data: structuredClone(slot.data) }) } : null\n\t\t)\n\t}\n}\n\n/**\n * Makes a hero of a world what a record says it was: its level, experience and points, its abilities as far as they\n * were learned, and its items in their slots. In place of what it had. What the game no longer has, an ability or an\n * item, is left out. Whole: health and mana full, nothing cooling down\n *\n * @beta\n */\nexport function applyHeroRecord(world: World, hero: Entity, record: HeroRecord): void {\n\tconst state = heroOf(hero)\n\tif (!state) throw new Error(`${hero.def.id} is no hero to carry a hero into`)\n\tstate.level = Math.max(1, Math.min(Math.floor(record.level), maxLevelOf(world, hero)))\n\tstate.xp = Math.max(record.xp, world.settings.heroes.xpForLevel(state.level))\n\tstate.points = Math.max(Math.floor(record.points), 0)\n\tfor (const ability of hero.abilities) {\n\t\tconst level = record.abilities[ability.id] ?? 0\n\t\tconst max = world.registry.abilities.has(ability.id) ? (world.registry.ability(ability.id).maxLevel ?? 3) : 0\n\t\tability.level = Math.min(level, max)\n\t\treadyAgain(ability)\n\t\tability.autocast = ability.level > 0 && (world.registry.ability(ability.id).autocast ?? false)\n\t}\n\tconst slots = slotsOf(hero)\n\tif (slots) {\n\t\tslots.fill(null)\n\t\trecord.items.forEach((carried, slot) => {\n\t\t\tif (!carried || slot >= slots.length || !world.registry.items.has(carried.item)) return\n\t\t\tconst instance = createItem(world, carried.item, carried.charges)\n\t\t\tif (carried.data) instance.data = structuredClone(carried.data)\n\t\t\tslots[slot] = instance\n\t\t})\n\t\tworld.events.emit(inventoryChanged, { entity: hero })\n\t}\n\trefreshVitals(world, hero)\n\thero.health = hero.maxHealth\n\thero.mana = hero.maxMana\n}\n\n/**\n * A hero made from a record (see `heroRecord`) for a player at a point, under the name it had unless told another\n *\n * @beta\n */\nexport function heroFromRecord(world: World, record: HeroRecord, owner: PlayerId, at: Vec2, options: SpawnOptions = {}): Entity {\n\tconst name = options.name ?? record.name\n\tconst hero = world.spawn(record.type, owner, at, { ...options, ...(name !== undefined && { name }) })\n\tapplyHeroRecord(world, hero, record)\n\treturn hero\n}\n\n/**\n * A record read back from what was kept (a campaign's progress, a file), checked. Throws on what is wrong\n *\n * @beta\n */\nexport function readHeroRecord(data: unknown): HeroRecord {\n\tconst record = data as Partial<HeroRecord> | null\n\tif (typeof record !== 'object' || record === null) throw new Error('A hero record is an object')\n\tif (typeof record.type !== 'string' || !record.type) throw new Error('A hero record says what type of unit it is')\n\tconst number = (value: unknown, what: string) => {\n\t\tif (typeof value !== 'number' || !Number.isFinite(value)) throw new Error(`A hero record's ${what} is a number`)\n\t\treturn value\n\t}\n\tconst abilities = record.abilities ?? {}\n\tif (typeof abilities !== 'object' || Array.isArray(abilities)) throw new Error(\"A hero record's abilities are levels by id\")\n\treturn {\n\t\ttype: record.type,\n\t\t...(typeof record.name === 'string' && { name: record.name }),\n\t\tlevel: number(record.level, 'level'),\n\t\txp: number(record.xp ?? 0, 'experience'),\n\t\tpoints: number(record.points ?? 0, 'points'),\n\t\tabilities: Object.fromEntries(Object.entries(abilities).map(([id, level]) => [id, number(level, `level of ${id}`)])),\n\t\titems: (Array.isArray(record.items) ? record.items : []).map((slot) =>\n\t\t\tslot && typeof slot === 'object' && typeof (slot as HeroItem).item === 'string'\n\t\t\t\t? {\n\t\t\t\t\t\titem: (slot as HeroItem).item,\n\t\t\t\t\t\tcharges: number((slot as HeroItem).charges ?? 0, 'charges'),\n\t\t\t\t\t\t...((slot as HeroItem).data && { data: (slot as HeroItem).data })\n\t\t\t\t\t}\n\t\t\t\t: null\n\t\t)\n\t}\n}\n"],"mappings":"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"}

package/dist/packs/heroes/commands.js

@@ -0,0 +1,115 @@
+import { learn } from "../../hero.js";
+import { id, index, optional, string } from "../../fields.js";
+import { buy, sell, undoBuy } from "../../items.js";
+import { enqueueRevive } from "../../systems/production.js";
+import { defineCommand, known, leastBusy, owned, producers } from "../../commands.js";
+import { hire } from "./hire.js";
+import { buyBack } from "./loop.js";
+//#region src/packs/heroes/commands.ts
+/**
+* The heroes pack's commands: buying and selling at a shop, taking a purchase back, hiring, putting a point into an ability, bringing a hero
+* back at an altar. Taken by a world whose game has the pack on (`heroesPack`); a game without it refuses them as it
+* does any command it does not know. Their type is among `Command`s, as the pack adds it (`Commands`)
+*/
+/**
+* Buys from a shop, for the hero that is named, or else the one of the player that stands closest to it
+*
+* @internal
+*/
+var buyCommand = defineCommand("buy", {
+	shop: id,
+	item: string,
+	hero: optional(id)
+}, (world, player, command) => {
+	const shop = known(world, player, command.shop);
+	const [buyer] = command.hero === void 0 ? [] : owned(world, player, [command.hero]);
+	if (shop && !world.areEnemies(shop.owner, player)) buy(world, shop, command.item, player, buyer);
+});
+/**
+* Hires a unit at a place that hires, a tavern or a dock: someone of the player's has to be there
+*
+* @internal
+*/
+var hireCommand = defineCommand("hire", {
+	shop: id,
+	unit: string
+}, (world, player, command) => {
+	const shop = known(world, player, command.shop);
+	if (shop) hire(world, shop, command.unit, player);
+});
+/**
+* Gives something a hero carries back at a shop nearby, for a part of its price
+*
+* @internal
+*/
+var sellCommand = defineCommand("sell", {
+	entity: id,
+	item: index
+}, (world, player, command) => {
+	const [seller] = owned(world, player, [command.entity]);
+	if (seller) sell(world, seller, command.item);
+});
+/**
+* Takes a purchase of a hero's back (`undoBuy`, `ShopSettings.undo`): the latest it may still undo, or the one named
+*
+* @internal
+*/
+var undoBuyCommand = defineCommand("undoBuy", {
+	hero: id,
+	purchase: optional(id)
+}, (world, player, command) => {
+	const [hero] = owned(world, player, [command.hero]);
+	if (hero) undoBuy(world, hero, command.purchase);
+});
+/**
+* Puts a point a hero has to spend into an ability
+*
+* @internal
+*/
+var learnCommand = defineCommand("learn", {
+	entity: id,
+	ability: string
+}, (world, player, command) => {
+	const [hero] = owned(world, player, [command.entity]);
+	if (hero) learn(world, hero, command.ability);
+});
+/**
+* The `revive` command: queues the revival of a dead hero at the player's least busy building that revives
+*
+* @internal
+*/
+var reviveCommand = defineCommand("revive", {
+	...producers,
+	hero: id
+}, (world, player, command) => {
+	const building = leastBusy(world, player, command, (entity) => !!entity.def.revives);
+	if (building) enqueueRevive(world, building, command.hero);
+});
+/**
+* The `buyback` command: a fallen hero of the player's back at once, for its price (`buyBack`)
+*
+* @internal
+*/
+var buybackCommand = defineCommand("buyback", { hero: id }, (world, player, command) => {
+	const hero = world.entities.get(command.hero);
+	if (hero && hero.owner === player) buyBack(world, hero);
+});
+/**
+* The commands of the heroes pack (`heroesPack`): buying, hiring, selling, learning, bringing a hero back at an altar
+* or buying it back. A game without the pack refuses them as it does any command it does not know
+*
+* @internal
+*/
+var heroCommands = [
+	buyCommand,
+	hireCommand,
+	sellCommand,
+	undoBuyCommand,
+	learnCommand,
+	reviveCommand,
+	buybackCommand
+];
+//#endregion
+export { buyCommand, buybackCommand, heroCommands, hireCommand, learnCommand, reviveCommand, sellCommand, undoBuyCommand };
+
+//# sourceMappingURL=commands.js.map

package/dist/packs/heroes/commands.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"commands.js","names":[],"sources":["../../../src/packs/heroes/commands.ts"],"sourcesContent":["/**\n * The heroes pack's commands: buying and selling at a shop, taking a purchase back, hiring, putting a point into an ability, bringing a hero\n * back at an altar. Taken by a world whose game has the pack on (`heroesPack`); a game without it refuses them as it\n * does any command it does not know. Their type is among `Command`s, as the pack adds it (`Commands`)\n */\nimport { defineCommand, known, leastBusy, owned, producers } from '#engine/commands'\nimport { id, index, optional, string } from '#engine/fields'\nimport { learn } from '#engine/hero'\nimport { buy, sell, undoBuy } from '#engine/items'\nimport { enqueueRevive } from '#engine/systems/production'\nimport { hire } from './hire'\nimport { buyBack } from './loop'\n\n/**\n * Buys from a shop, for the hero that is named, or else the one of the player that stands closest to it\n *\n * @internal\n */\nexport const buyCommand = defineCommand('buy', { shop: id, item: string, hero: optional(id) }, (world, player, command) => {\n\t// shops sell to whoever comes by, not only to their owner\n\tconst shop = known(world, player, command.shop)\n\tconst [buyer] = command.hero === undefined ? [] : owned(world, player, [command.hero])\n\tif (shop && !world.areEnemies(shop.owner, player)) buy(world, shop, command.item, player, buyer)\n})\n\n/**\n * Hires a unit at a place that hires, a tavern or a dock: someone of the player's has to be there\n *\n * @internal\n */\nexport const hireCommand = defineCommand('hire', { shop: id, unit: string }, (world, player, command) => {\n\tconst shop = known(world, player, command.shop)\n\tif (shop) hire(world, shop, command.unit, player)\n})\n\n/**\n * Gives something a hero carries back at a shop nearby, for a part of its price\n *\n * @internal\n */\nexport const sellCommand = defineCommand('sell', { entity: id, item: index }, (world, player, command) => {\n\tconst [seller] = owned(world, player, [command.entity])\n\tif (seller) sell(world, seller, command.item)\n})\n\n/**\n * Takes a purchase of a hero's back (`undoBuy`, `ShopSettings.undo`): the latest it may still undo, or the one named\n *\n * @internal\n */\nexport const undoBuyCommand = defineCommand('undoBuy', { hero: id, purchase: optional(id) }, (world, player, command) => {\n\tconst [hero] = owned(world, player, [command.hero])\n\tif (hero) undoBuy(world, hero, command.purchase)\n})\n\n/**\n * Puts a point a hero has to spend into an ability\n *\n * @internal\n */\nexport const learnCommand = defineCommand('learn', { entity: id, ability: string }, (world, player, command) => {\n\tconst [hero] = owned(world, player, [command.entity])\n\tif (hero) learn(world, hero, command.ability)\n})\n\n/**\n * The `revive` command: queues the revival of a dead hero at the player's least busy building that revives\n *\n * @internal\n */\nexport const reviveCommand = defineCommand('revive', { ...producers, hero: id }, (world, player, command) => {\n\tconst building = leastBusy(world, player, command, (entity) => !!entity.def.revives)\n\tif (building) enqueueRevive(world, building, command.hero)\n})\n\n/**\n * The `buyback` command: a fallen hero of the player's back at once, for its price (`buyBack`)\n *\n * @internal\n */\nexport const buybackCommand = defineCommand('buyback', { hero: id }, (world, player, command) => {\n\tconst hero = world.entities.get(command.hero)\n\tif (hero && hero.owner === player) buyBack(world, hero)\n})\n\n/**\n * The commands of the heroes pack (`heroesPack`): buying, hiring, selling, learning, bringing a hero back at an altar\n * or buying it back. A game without the pack refuses them as it does any command it does not know\n *\n * @internal\n */\nexport const heroCommands = [buyCommand, hireCommand, sellCommand, undoBuyCommand, learnCommand, reviveCommand, buybackCommand] as const\n\ndeclare module '#engine/commands' {\n\tinterface Commands {\n\t\theroes: (typeof heroCommands)[number]\n\t}\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;AAkBA,IAAa,aAAa,cAAc,OAAO;CAAE,MAAM;CAAI,MAAM;CAAQ,MAAM,SAAS,EAAE;AAAE,IAAI,OAAO,QAAQ,YAAY;CAE1H,MAAM,OAAO,MAAM,OAAO,QAAQ,QAAQ,IAAI;CAC9C,MAAM,CAAC,SAAS,QAAQ,SAAS,KAAA,IAAY,CAAC,IAAI,MAAM,OAAO,QAAQ,CAAC,QAAQ,IAAI,CAAC;CACrF,IAAI,QAAQ,CAAC,MAAM,WAAW,KAAK,OAAO,MAAM,GAAG,IAAI,OAAO,MAAM,QAAQ,MAAM,QAAQ,KAAK;AAChG,CAAC;;;;;;AAOD,IAAa,cAAc,cAAc,QAAQ;CAAE,MAAM;CAAI,MAAM;AAAO,IAAI,OAAO,QAAQ,YAAY;CACxG,MAAM,OAAO,MAAM,OAAO,QAAQ,QAAQ,IAAI;CAC9C,IAAI,MAAM,KAAK,OAAO,MAAM,QAAQ,MAAM,MAAM;AACjD,CAAC;;;;;;AAOD,IAAa,cAAc,cAAc,QAAQ;CAAE,QAAQ;CAAI,MAAM;AAAM,IAAI,OAAO,QAAQ,YAAY;CACzG,MAAM,CAAC,UAAU,MAAM,OAAO,QAAQ,CAAC,QAAQ,MAAM,CAAC;CACtD,IAAI,QAAQ,KAAK,OAAO,QAAQ,QAAQ,IAAI;AAC7C,CAAC;;;;;;AAOD,IAAa,iBAAiB,cAAc,WAAW;CAAE,MAAM;CAAI,UAAU,SAAS,EAAE;AAAE,IAAI,OAAO,QAAQ,YAAY;CACxH,MAAM,CAAC,QAAQ,MAAM,OAAO,QAAQ,CAAC,QAAQ,IAAI,CAAC;CAClD,IAAI,MAAM,QAAQ,OAAO,MAAM,QAAQ,QAAQ;AAChD,CAAC;;;;;;AAOD,IAAa,eAAe,cAAc,SAAS;CAAE,QAAQ;CAAI,SAAS;AAAO,IAAI,OAAO,QAAQ,YAAY;CAC/G,MAAM,CAAC,QAAQ,MAAM,OAAO,QAAQ,CAAC,QAAQ,MAAM,CAAC;CACpD,IAAI,MAAM,MAAM,OAAO,MAAM,QAAQ,OAAO;AAC7C,CAAC;;;;;;AAOD,IAAa,gBAAgB,cAAc,UAAU;CAAE,GAAG;CAAW,MAAM;AAAG,IAAI,OAAO,QAAQ,YAAY;CAC5G,MAAM,WAAW,UAAU,OAAO,QAAQ,UAAU,WAAW,CAAC,CAAC,OAAO,IAAI,OAAO;CACnF,IAAI,UAAU,cAAc,OAAO,UAAU,QAAQ,IAAI;AAC1D,CAAC;;;;;;AAOD,IAAa,iBAAiB,cAAc,WAAW,EAAE,MAAM,GAAG,IAAI,OAAO,QAAQ,YAAY;CAChG,MAAM,OAAO,MAAM,SAAS,IAAI,QAAQ,IAAI;CAC5C,IAAI,QAAQ,KAAK,UAAU,QAAQ,QAAQ,OAAO,IAAI;AACvD,CAAC;;;;;;;AAQD,IAAa,eAAe;CAAC;CAAY;CAAa;CAAa;CAAgB;CAAc;CAAe;AAAc"}

package/dist/packs/heroes/fallen.d.ts

@@ -0,0 +1,43 @@
+import type { Entity, EntityId, PlayerId } from '#engine/entity';
+import type { Vec2 } from '#engine/math';
+import type { World } from '#engine/world';
+/**
+ * A hero that fell a moment ago (`fallenHeroes`): what it was, at what levels, where and when
+ *
+ * @beta
+ */
+export interface FallenRecord {
+    /** Its id: a fallen hero waits out of the world to be brought back, as the same entity */
+    id: EntityId;
+    /** Its unit type, as itself: one that fell in a form, the type it is as itself */
+    type: string;
+    /** Its player */
+    owner: PlayerId;
+    /** Its hero level */
+    level: number;
+    /** The levels of what it learns (its type's `hero.learns`), by ability id: what it had not learned is not there */
+    levels: Record<string, number>;
+    /** The game's time it fell, in seconds */
+    at: number;
+    /** Where it fell */
+    pos: Vec2;
+    /** Who killed it, if anyone */
+    killer?: EntityId;
+}
+/**
+ * The heroes that fell, as the heroes pack remembers them (`fallenHeroes`): saved with the world. Those older than
+ * `HeroSettings.fallenFor` go as the next falls
+ *
+ * @beta
+ */
+export declare const fallen: import("#engine/components").Component<FallenRecord[], FallenRecord[]>;
+/**
+ * The heroes that fell within the last `HeroSettings.fallenFor` seconds (8 when the game says nothing), the oldest first.
+ * Read it from a `death` listener (`entityDied`) to know what the hero that just fell was. None in a game without the
+ * heroes pack
+ *
+ * @beta
+ */
+export declare function fallenHeroes(world: World): readonly FallenRecord[];
+/** A hero falls: remembered, as itself, and those remembered past their time forgotten. Called by the pack's `death` hook */
+export declare function rememberFallen(world: World, entity: Entity, killer: Entity | undefined): void;

package/dist/packs/heroes/fallen.js

@@ -0,0 +1,61 @@
+import { defineComponent } from "../../components.js";
+import { form } from "../../formState.js";
+import { heroOf } from "../../hero.js";
+//#region src/packs/heroes/fallen.ts
+/**
+* Heroes that fell a moment ago (E2E-PLAN LB4): what each was where it fell, remembered a while by the heroes pack, for
+* a game's own that takes a fallen hero over (Viego's souls, a necromancer's echo of the dead)
+*/
+/**
+* The heroes that fell, as the heroes pack remembers them (`fallenHeroes`): saved with the world. Those older than
+* `HeroSettings.fallenFor` go as the next falls
+*
+* @beta
+*/
+var fallen = defineComponent({
+	id: "heroes.fallen",
+	default: () => []
+});
+/**
+* The heroes that fell within the last `HeroSettings.fallenFor` seconds (8 when the game says nothing), the oldest first.
+* Read it from a `death` listener (`entityDied`) to know what the hero that just fell was. None in a game without the
+* heroes pack
+*
+* @beta
+*/
+function fallenHeroes(world) {
+	if (!world.states.has(fallen)) return [];
+	const since = world.time - world.settings.heroes.fallenFor;
+	return world.state(fallen).filter((each) => each.at >= since);
+}
+/** A hero falls: remembered, as itself, and those remembered past their time forgotten. Called by the pack's `death` hook */
+function rememberFallen(world, entity, killer) {
+	const hero = heroOf(entity);
+	if (!hero) return;
+	const inForm = entity.get(form);
+	const type = inForm?.from ?? entity.def.id;
+	const had = [...entity.abilities, ...inForm?.kept ?? []];
+	const levels = {};
+	for (const id of world.registry.unit(type).hero?.learns ?? []) {
+		const level = had.find((state) => state.id === id)?.level ?? 0;
+		if (level > 0) levels[id] = level;
+	}
+	const since = world.time - world.settings.heroes.fallenFor;
+	world.setState(fallen, [...world.states.has(fallen) ? world.state(fallen).filter((each) => each.at >= since) : [], {
+		id: entity.id,
+		type,
+		owner: entity.owner,
+		level: hero.level,
+		levels,
+		at: world.time,
+		pos: {
+			x: entity.pos.x,
+			z: entity.pos.z
+		},
+		...killer && { killer: killer.id }
+	}]);
+}
+//#endregion
+export { fallen, fallenHeroes, rememberFallen };
+
+//# sourceMappingURL=fallen.js.map

package/dist/packs/heroes/fallen.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fallen.js","names":[],"sources":["../../../src/packs/heroes/fallen.ts"],"sourcesContent":["/**\n * Heroes that fell a moment ago (E2E-PLAN LB4): what each was where it fell, remembered a while by the heroes pack, for\n * a game's own that takes a fallen hero over (Viego's souls, a necromancer's echo of the dead)\n */\nimport { defineComponent } from '#engine/components'\nimport type { Entity, EntityId, PlayerId } from '#engine/entity'\nimport { form } from '#engine/formState'\nimport { heroOf } from '#engine/hero'\nimport type { Vec2 } from '#engine/math'\nimport type { World } from '#engine/world'\n\n/**\n * A hero that fell a moment ago (`fallenHeroes`): what it was, at what levels, where and when\n *\n * @beta\n */\nexport interface FallenRecord {\n\t/** Its id: a fallen hero waits out of the world to be brought back, as the same entity */\n\tid: EntityId\n\t/** Its unit type, as itself: one that fell in a form, the type it is as itself */\n\ttype: string\n\t/** Its player */\n\towner: PlayerId\n\t/** Its hero level */\n\tlevel: number\n\t/** The levels of what it learns (its type's `hero.learns`), by ability id: what it had not learned is not there */\n\tlevels: Record<string, number>\n\t/** The game's time it fell, in seconds */\n\tat: number\n\t/** Where it fell */\n\tpos: Vec2\n\t/** Who killed it, if anyone */\n\tkiller?: EntityId\n}\n\n/**\n * The heroes that fell, as the heroes pack remembers them (`fallenHeroes`): saved with the world. Those older than\n * `HeroSettings.fallenFor` go as the next falls\n *\n * @beta\n */\nexport const fallen = defineComponent<FallenRecord[]>({ id: 'heroes.fallen', default: () => [] })\n\n/**\n * The heroes that fell within the last `HeroSettings.fallenFor` seconds (8 when the game says nothing), the oldest first.\n * Read it from a `death` listener (`entityDied`) to know what the hero that just fell was. None in a game without the\n * heroes pack\n *\n * @beta\n */\nexport function fallenHeroes(world: World): readonly FallenRecord[] {\n\tif (!world.states.has(fallen)) return []\n\tconst since = world.time - world.settings.heroes.fallenFor\n\treturn world.state(fallen).filter((each) => each.at >= since)\n}\n\n/** A hero falls: remembered, as itself, and those remembered past their time forgotten. Called by the pack's `death` hook */\nexport function rememberFallen(world: World, entity: Entity, killer: Entity | undefined): void {\n\tconst hero = heroOf(entity)\n\tif (!hero) return\n\tconst inForm = entity.get(form)\n\tconst type = inForm?.from ?? entity.def.id\n\tconst had = [...entity.abilities, ...(inForm?.kept ?? [])]\n\tconst levels: Record<string, number> = {}\n\tfor (const id of world.registry.unit(type).hero?.learns ?? []) {\n\t\tconst level = had.find((state) => state.id === id)?.level ?? 0\n\t\tif (level > 0) levels[id] = level\n\t}\n\tconst since = world.time - world.settings.heroes.fallenFor\n\tworld.setState(fallen, [\n\t\t...(world.states.has(fallen) ? world.state(fallen).filter((each) => each.at >= since) : []),\n\t\t{\n\t\t\tid: entity.id,\n\t\t\ttype,\n\t\t\towner: entity.owner,\n\t\t\tlevel: hero.level,\n\t\t\tlevels,\n\t\t\tat: world.time,\n\t\t\tpos: { x: entity.pos.x, z: entity.pos.z },\n\t\t\t...(killer && { killer: killer.id })\n\t\t}\n\t])\n}\n"],"mappings":";;;;;;;;;;;;;;AAyCA,IAAa,SAAS,gBAAgC;CAAE,IAAI;CAAiB,eAAe,CAAC;AAAE,CAAC;;;;;;;;AAShG,SAAgB,aAAa,OAAuC;CACnE,IAAI,CAAC,MAAM,OAAO,IAAI,MAAM,GAAG,OAAO,CAAC;CACvC,MAAM,QAAQ,MAAM,OAAO,MAAM,SAAS,OAAO;CACjD,OAAO,MAAM,MAAM,MAAM,CAAC,CAAC,QAAQ,SAAS,KAAK,MAAM,KAAK;AAC7D;;AAGA,SAAgB,eAAe,OAAc,QAAgB,QAAkC;CAC9F,MAAM,OAAO,OAAO,MAAM;CAC1B,IAAI,CAAC,MAAM;CACX,MAAM,SAAS,OAAO,IAAI,IAAI;CAC9B,MAAM,OAAO,QAAQ,QAAQ,OAAO,IAAI;CACxC,MAAM,MAAM,CAAC,GAAG,OAAO,WAAW,GAAI,QAAQ,QAAQ,CAAC,CAAE;CACzD,MAAM,SAAiC,CAAC;CACxC,KAAK,MAAM,MAAM,MAAM,SAAS,KAAK,IAAI,CAAC,CAAC,MAAM,UAAU,CAAC,GAAG;EAC9D,MAAM,QAAQ,IAAI,MAAM,UAAU,MAAM,OAAO,EAAE,CAAC,EAAE,SAAS;EAC7D,IAAI,QAAQ,GAAG,OAAO,MAAM;CAC7B;CACA,MAAM,QAAQ,MAAM,OAAO,MAAM,SAAS,OAAO;CACjD,MAAM,SAAS,QAAQ,CACtB,GAAI,MAAM,OAAO,IAAI,MAAM,IAAI,MAAM,MAAM,MAAM,CAAC,CAAC,QAAQ,SAAS,KAAK,MAAM,KAAK,IAAI,CAAC,GACzF;EACC,IAAI,OAAO;EACX;EACA,OAAO,OAAO;EACd,OAAO,KAAK;EACZ;EACA,IAAI,MAAM;EACV,KAAK;GAAE,GAAG,OAAO,IAAI;GAAG,GAAG,OAAO,IAAI;EAAE;EACxC,GAAI,UAAU,EAAE,QAAQ,OAAO,GAAG;CACnC,CACD,CAAC;AACF"}

package/dist/packs/heroes/hire.js

@@ -0,0 +1,60 @@
+import { unitHired } from "../../engineEvents.js";
+import { shortOf, spend } from "../../player.js";
+import { engineMessage } from "../../messages.js";
+import { heroesOf } from "../../hero.js";
+import { atShop } from "../../items.js";
+//#region src/packs/heroes/hire.ts
+/**
+* Whether someone of a player's stands at a place that hires (`UnitTypeDef.hires`) to hire there: any unit of theirs
+* close enough, as at a shop. The first one found
+*
+* @internal
+*/
+function hirerAt(world, shop, player) {
+	for (const entity of world.index.ownedBy(player)) if (entity.alive && !entity.hidden && entity.def.kind === "unit" && atShop(entity, shop)) return entity;
+}
+/**
+* Why a player cannot hire a unit at a place now, as the message the player is told: none of theirs there, a hero
+* they have already (a hero is hired once), as many heroes as they may have, what it costs. Nothing when they can
+*
+* @internal
+*/
+function hireRefusal(world, shop, unit, player) {
+	if (!shop.def.hires?.includes(unit) || !world.registry.units.has(unit)) return engineMessage("cannotDoThat");
+	if (!shop.alive || !shop.operational || world.areEnemies(shop.owner, player)) return engineMessage("cannotDoThat");
+	const def = world.registry.unit(unit);
+	if (def.hero && heroesOf(world, player).some((hero) => hero.def.id === unit)) return engineMessage("alreadyHired", { unit });
+	if (def.hero && heroesOf(world, player).length >= world.settings.heroes.maxHeroes) return engineMessage("tooManyHeroes");
+	if (!hirerAt(world, shop, player)) return engineMessage("unitAtShop");
+	const short = shortOf(world.player(player).resources, def.cost);
+	if (short) return engineMessage("notEnough", { resource: short });
+}
+/**
+* Hires a unit at a place that hires for a player: a tavern's hero, a dock's boat. Paid for, and made next to the
+* place, a boat on the water nearest it. The unit, or nothing with the player told why
+*
+* @beta
+*/
+function hire(world, shop, unit, player) {
+	const refusal = hireRefusal(world, shop, unit, player);
+	if (refusal) {
+		world.message(player, refusal);
+		return;
+	}
+	const def = world.registry.unit(unit);
+	spend(world, player, def.cost, "hire", unit);
+	const hired = world.spawn(unit, player, {
+		x: shop.pos.x,
+		z: shop.pos.z + shop.def.radius + def.radius + .5
+	});
+	world.events.emit(unitHired, {
+		shop,
+		unit: hired,
+		player
+	});
+	return hired;
+}
+//#endregion
+export { hire, hireRefusal, hirerAt };
+
+//# sourceMappingURL=hire.js.map

package/dist/packs/heroes/hire.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hire.js","names":[],"sources":["../../../src/packs/heroes/hire.ts"],"sourcesContent":["import { unitHired } from '#engine/engineEvents'\nimport type { Entity, PlayerId } from '#engine/entity'\nimport { heroesOf } from '#engine/hero'\nimport { atShop } from '#engine/items'\nimport { engineMessage } from '#engine/messages'\nimport { shortOf, spend } from '#engine/player'\nimport type { World } from '#engine/world'\n\n/**\n * Whether someone of a player's stands at a place that hires (`UnitTypeDef.hires`) to hire there: any unit of theirs\n * close enough, as at a shop. The first one found\n *\n * @internal\n */\nexport function hirerAt(world: World, shop: Entity, player: PlayerId): Entity | undefined {\n\tfor (const entity of world.index.ownedBy(player))\n\t\tif (entity.alive && !entity.hidden && entity.def.kind === 'unit' && atShop(entity, shop)) return entity\n\treturn undefined\n}\n\n/**\n * Why a player cannot hire a unit at a place now, as the message the player is told: none of theirs there, a hero\n * they have already (a hero is hired once), as many heroes as they may have, what it costs. Nothing when they can\n *\n * @internal\n */\nexport function hireRefusal(world: World, shop: Entity, unit: string, player: PlayerId) {\n\tif (!shop.def.hires?.includes(unit) || !world.registry.units.has(unit)) return engineMessage('cannotDoThat')\n\tif (!shop.alive || !shop.operational || world.areEnemies(shop.owner, player)) return engineMessage('cannotDoThat')\n\tconst def = world.registry.unit(unit)\n\tif (def.hero && heroesOf(world, player).some((hero) => hero.def.id === unit)) return engineMessage('alreadyHired', { unit })\n\t// no more heroes than the game lets a player have, however they come (`HeroSettings.maxHeroes`)\n\tif (def.hero && heroesOf(world, player).length >= world.settings.heroes.maxHeroes) return engineMessage('tooManyHeroes')\n\tif (!hirerAt(world, shop, player)) return engineMessage('unitAtShop')\n\tconst short = shortOf(world.player(player).resources, def.cost)\n\tif (short) return engineMessage('notEnough', { resource: short })\n\treturn undefined\n}\n\n/**\n * Hires a unit at a place that hires for a player: a tavern's hero, a dock's boat. Paid for, and made next to the\n * place, a boat on the water nearest it. The unit, or nothing with the player told why\n *\n * @beta\n */\nexport function hire(world: World, shop: Entity, unit: string, player: PlayerId): Entity | undefined {\n\tconst refusal = hireRefusal(world, shop, unit, player)\n\tif (refusal) {\n\t\tworld.message(player, refusal)\n\t\treturn undefined\n\t}\n\tconst def = world.registry.unit(unit)\n\tspend(world, player, def.cost, 'hire', unit)\n\tconst hired = world.spawn(unit, player, { x: shop.pos.x, z: shop.pos.z + shop.def.radius + def.radius + 0.5 })\n\tworld.events.emit(unitHired, { shop, unit: hired, player })\n\treturn hired\n}\n"],"mappings":";;;;;;;;;;;;AAcA,SAAgB,QAAQ,OAAc,MAAc,QAAsC;CACzF,KAAK,MAAM,UAAU,MAAM,MAAM,QAAQ,MAAM,GAC9C,IAAI,OAAO,SAAS,CAAC,OAAO,UAAU,OAAO,IAAI,SAAS,UAAU,OAAO,QAAQ,IAAI,GAAG,OAAO;AAEnG;;;;;;;AAQA,SAAgB,YAAY,OAAc,MAAc,MAAc,QAAkB;CACvF,IAAI,CAAC,KAAK,IAAI,OAAO,SAAS,IAAI,KAAK,CAAC,MAAM,SAAS,MAAM,IAAI,IAAI,GAAG,OAAO,cAAc,cAAc;CAC3G,IAAI,CAAC,KAAK,SAAS,CAAC,KAAK,eAAe,MAAM,WAAW,KAAK,OAAO,MAAM,GAAG,OAAO,cAAc,cAAc;CACjH,MAAM,MAAM,MAAM,SAAS,KAAK,IAAI;CACpC,IAAI,IAAI,QAAQ,SAAS,OAAO,MAAM,CAAC,CAAC,MAAM,SAAS,KAAK,IAAI,OAAO,IAAI,GAAG,OAAO,cAAc,gBAAgB,EAAE,KAAK,CAAC;CAE3H,IAAI,IAAI,QAAQ,SAAS,OAAO,MAAM,CAAC,CAAC,UAAU,MAAM,SAAS,OAAO,WAAW,OAAO,cAAc,eAAe;CACvH,IAAI,CAAC,QAAQ,OAAO,MAAM,MAAM,GAAG,OAAO,cAAc,YAAY;CACpE,MAAM,QAAQ,QAAQ,MAAM,OAAO,MAAM,CAAC,CAAC,WAAW,IAAI,IAAI;CAC9D,IAAI,OAAO,OAAO,cAAc,aAAa,EAAE,UAAU,MAAM,CAAC;AAEjE;;;;;;;AAQA,SAAgB,KAAK,OAAc,MAAc,MAAc,QAAsC;CACpG,MAAM,UAAU,YAAY,OAAO,MAAM,MAAM,MAAM;CACrD,IAAI,SAAS;EACZ,MAAM,QAAQ,QAAQ,OAAO;EAC7B;CACD;CACA,MAAM,MAAM,MAAM,SAAS,KAAK,IAAI;CACpC,MAAM,OAAO,QAAQ,IAAI,MAAM,QAAQ,IAAI;CAC3C,MAAM,QAAQ,MAAM,MAAM,MAAM,QAAQ;EAAE,GAAG,KAAK,IAAI;EAAG,GAAG,KAAK,IAAI,IAAI,KAAK,IAAI,SAAS,IAAI,SAAS;CAAI,CAAC;CAC7G,MAAM,OAAO,KAAK,WAAW;EAAE;EAAM,MAAM;EAAO;CAAO,CAAC;CAC1D,OAAO;AACR"}

package/dist/packs/heroes/index.d.ts

@@ -1,12 +1,13 @@
-import { type HeroesPack, type HeroRules } from '#engine/hero';
+import { type HeroesPack, type HeroSettings } from '#engine/hero';
 /**
- * The heroes pack: what makes a game a classic hero RTS, opted into (`GameModule.packs: [withHeroes()]`). Heroes, with
- * their experience, levels, points and abilities to learn, brought back at an altar (`revive`); creeps' camps that guard
+ * The heroes pack: what makes a game a classic hero RTS, opted into (`Rules.packs: [heroesPack()]`). Heroes, with
+ * their experience, levels, points and abilities to learn, brought back at an altar (`revive`) or bought back
+ * (`buyback`), their kills shared with those who assisted, their streaks paid for when they end (`HeroSettings`); creeps' camps that guard
  * their ground, sleep at night and come back (`Camp.respawn`); shops that sell (`buy`, `sell`) and places that hire
- * (`hire`). `rules` change its numbers (`HeroRules`: how many heroes, the experience a level takes), the classic RTS numbers for
+ * (`hire`). `rules` change its numbers (`HeroSettings`: how many heroes, the experience a level takes), the classic RTS numbers for
  * those left out. A game without it pays nothing for any of it: no hero is made of a hero's type, no command of these
  * is taken, no camp is looked at
  *
- * @beta
+ * @public
  */
-export declare function withHeroes(rules?: Partial<HeroRules>): HeroesPack;
+export declare function heroesPack(rules?: Partial<HeroSettings>): HeroesPack;

package/dist/packs/heroes/index.js

@@ -0,0 +1,130 @@
+import { HEROES, defaultHeroSettings, heroOf, heroState, keepInnate } from "../../hero.js";
+import { defineHook } from "../../hooks.js";
+import { shopStock } from "../../items.js";
+import { corpseSystem, worthless } from "../../summons.js";
+import { campHooks, campListeners, campRespawnSystem } from "../../camps.js";
+import { assistListeners, assistLog, heroAssists, heroTally, settleHeroKill } from "./loop.js";
+import { heroCommands } from "./commands.js";
+import { awardKill, makeHero } from "./making.js";
+import { fallen, rememberFallen } from "./fallen.js";
+//#region src/packs/heroes/index.ts
+/** A shop's wares, each as many as it stocks; what it stocked already as it was, where it sells it still */
+function stockShop(world, entity) {
+	const sells = entity.def.sells ?? [];
+	const had = entity.get(shopStock);
+	if (!sells.length) {
+		if (had) entity.remove(shopStock);
+		return;
+	}
+	entity.set(shopStock, sells.map((item) => {
+		const kept = had?.find((stock) => stock.item === item);
+		if (kept) return kept;
+		const stock = world.registry.item(item).stock;
+		return {
+			item,
+			count: stock?.max ?? 1,
+			restock: stock?.restock ?? 60
+		};
+	}));
+}
+/** What the pack does as things are made, change type, die and fall: heroes, their experience, shops' wares */
+var heroHooks = [
+	defineHook({
+		hook: "made",
+		id: "hero",
+		run(world, entity) {
+			if (entity.def.hero) makeHero(world, entity);
+			stockShop(world, entity);
+		}
+	}),
+	defineHook({
+		hook: "morphed",
+		id: "hero",
+		run(world, { entity }) {
+			if (entity.def.hero && !entity.has(heroState)) makeHero(world, entity);
+			else if (entity.def.hero) keepInnate(world, entity);
+			if (entity.def.sells?.length || entity.has(shopStock)) stockShop(world, entity);
+		}
+	}),
+	defineHook({
+		hook: "death",
+		id: "experience",
+		run(world, { entity, killer }) {
+			if (worthless(entity)) return;
+			const assists = heroAssists(world, entity, killer);
+			awardKill(world, entity, killer, assists);
+			if (entity.has(heroState)) settleHeroKill(world, entity, killer, assists);
+		}
+	}),
+	defineHook({
+		hook: "death",
+		id: "fallen",
+		run(world, { entity, killer }) {
+			if (entity.has(heroState) && !worthless(entity)) rememberFallen(world, entity, killer);
+		}
+	}),
+	defineHook({
+		hook: "fallenHero",
+		id: "heroesStay",
+		run(_world, event) {
+			if (event.entity.has(heroState)) event.stays = true;
+		}
+	}),
+	...campHooks
+];
+/**
+* A hero's stats grow with its level, as its type says (`UnitTypeDef.hero.growth`): stamped with the level past the
+* first, so that a level set however it is set is added up again
+*/
+var heroGrowth = {
+	id: "heroGrowth",
+	stamp(entity) {
+		if (!entity.def.hero) return 0;
+		const level = heroOf(entity)?.level ?? 1;
+		return level > 1 ? level : 0;
+	},
+	add(_world, entity, sum) {
+		const growth = entity.def.hero?.growth;
+		const hero = growth && heroOf(entity);
+		if (hero && hero.level > 1) sum.add(growth, hero.level - 1);
+	}
+};
+/** Camps come back as the engine's own did: in the clean-up, before the corpses go */
+var campsComeBack = {
+	...campRespawnSystem,
+	before: [corpseSystem.name]
+};
+/**
+* The heroes pack: what makes a game a classic hero RTS, opted into (`Rules.packs: [heroesPack()]`). Heroes, with
+* their experience, levels, points and abilities to learn, brought back at an altar (`revive`) or bought back
+* (`buyback`), their kills shared with those who assisted, their streaks paid for when they end (`HeroSettings`); creeps' camps that guard
+* their ground, sleep at night and come back (`Camp.respawn`); shops that sell (`buy`, `sell`) and places that hire
+* (`hire`). `rules` change its numbers (`HeroSettings`: how many heroes, the experience a level takes), the classic RTS numbers for
+* those left out. A game without it pays nothing for any of it: no hero is made of a hero's type, no command of these
+* is taken, no camp is looked at
+*
+* @public
+*/
+function heroesPack(rules = {}) {
+	for (const key of Object.keys(rules)) if (!(key in defaultHeroSettings)) throw new Error(`"${key}" is not a rule of the heroes pack`);
+	return {
+		id: HEROES,
+		options: rules,
+		callings: rules.callings ?? defaultHeroSettings.callings,
+		settings: () => ({ heroes: rules }),
+		commands: [...heroCommands],
+		systems: [campsComeBack],
+		hooks: heroHooks,
+		listeners: [...campListeners, ...assistListeners],
+		components: [
+			fallen,
+			assistLog,
+			heroTally
+		],
+		statFields: [heroGrowth]
+	};
+}
+//#endregion
+export { heroesPack };
+
+//# sourceMappingURL=index.js.map

package/dist/packs/heroes/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"sources":["../../../src/packs/heroes/index.ts"],"sourcesContent":["import type { CommandDef } from '#engine/commands'\nimport { heroCommands } from './commands'\nimport { campHooks, campListeners, campRespawnSystem } from '#engine/camps'\nimport { defineHook, type HookDef } from '#engine/hooks'\nimport { defaultHeroSettings, HEROES, type HeroesPack, type HeroSettings, heroOf, heroState, keepInnate } from '#engine/hero'\nimport { awardKill, makeHero } from './making'\nimport { fallen, rememberFallen } from './fallen'\nimport { assistListeners, assistLog, heroAssists, heroTally, settleHeroKill } from './loop'\nimport { shopStock } from '#engine/items'\nimport { corpseSystem, worthless } from '#engine/summons'\nimport type { System } from '#engine/registry'\nimport type { StatField } from '#engine/stats'\nimport type { Entity } from '#engine/entity'\nimport type { World } from '#engine/world'\n\n/** A shop's wares, each as many as it stocks; what it stocked already as it was, where it sells it still */\nfunction stockShop(world: World, entity: Entity): void {\n\tconst sells = entity.def.sells ?? []\n\tconst had = entity.get(shopStock)\n\tif (!sells.length) {\n\t\tif (had) entity.remove(shopStock)\n\t\treturn\n\t}\n\tentity.set(\n\t\tshopStock,\n\t\tsells.map((item) => {\n\t\t\tconst kept = had?.find((stock) => stock.item === item)\n\t\t\tif (kept) return kept\n\t\t\tconst stock = world.registry.item(item).stock\n\t\t\treturn { item, count: stock?.max ?? 1, restock: stock?.restock ?? 60 }\n\t\t})\n\t)\n}\n\n/** What the pack does as things are made, change type, die and fall: heroes, their experience, shops' wares */\nconst heroHooks: HookDef[] = [\n\tdefineHook({\n\t\thook: 'made',\n\t\tid: 'hero',\n\t\trun(world, entity) {\n\t\t\t// a hero of a hero's type: level 1, a point to spend, what it learns\n\t\t\tif (entity.def.hero) makeHero(world, entity)\n\t\t\tstockShop(world, entity)\n\t\t}\n\t}),\n\tdefineHook({\n\t\thook: 'morphed',\n\t\tid: 'hero',\n\t\trun(world, { entity }) {\n\t\t\t// what became a hero's type is a hero from level 1; a hero that stays one keeps its level and what it learned,\n\t\t\t// and has the innate of the form it took (`HeroDef.innate`)\n\t\t\tif (entity.def.hero && !entity.has(heroState)) makeHero(world, entity)\n\t\t\telse if (entity.def.hero) keepInnate(world, entity)\n\t\t\t// what became a shop stocks its wares; one that sells no more has none\n\t\t\tif (entity.def.sells?.length || entity.has(shopStock)) stockShop(world, entity)\n\t\t}\n\t}),\n\tdefineHook({\n\t\thook: 'death',\n\t\tid: 'experience',\n\t\trun(world, { entity, killer }) {\n\t\t\t// an illusion gains its killer nothing\n\t\t\tif (worthless(entity)) return\n\t\t\t// a hero's kill is shared with those who assisted it (`HeroSettings.assistTime`), and settles the streaks\n\t\t\tconst assists = heroAssists(world, entity, killer)\n\t\t\tawardKill(world, entity, killer, assists)\n\t\t\tif (entity.has(heroState)) settleHeroKill(world, entity, killer, assists)\n\t\t}\n\t}),\n\tdefineHook({\n\t\thook: 'death',\n\t\tid: 'fallen',\n\t\trun(world, { entity, killer }) {\n\t\t\t// a hero is remembered a while as it fell (`fallenHeroes`); an illusion is nobody\n\t\t\tif (entity.has(heroState) && !worthless(entity)) rememberFallen(world, entity, killer)\n\t\t}\n\t}),\n\tdefineHook({\n\t\thook: 'fallenHero',\n\t\tid: 'heroesStay',\n\t\trun(_world, event) {\n\t\t\t// a fallen hero waits out of the world to be brought back: at an altar, by its own time (`respawnPack`)\n\t\t\tif (event.entity.has(heroState)) event.stays = true\n\t\t}\n\t}),\n\t...campHooks\n]\n\n/**\n * A hero's stats grow with its level, as its type says (`UnitTypeDef.hero.growth`): stamped with the level past the\n * first, so that a level set however it is set is added up again\n */\nconst heroGrowth: StatField = {\n\tid: 'heroGrowth',\n\tstamp(entity) {\n\t\tif (!entity.def.hero) return 0\n\t\tconst level = heroOf(entity)?.level ?? 1\n\t\treturn level > 1 ? level : 0\n\t},\n\tadd(_world, entity, sum) {\n\t\tconst growth = entity.def.hero?.growth\n\t\tconst hero = growth && heroOf(entity)\n\t\tif (hero && hero.level > 1) sum.add(growth, hero.level - 1)\n\t}\n}\n\n/** Camps come back as the engine's own did: in the clean-up, before the corpses go */\nconst campsComeBack: System = { ...campRespawnSystem, before: [corpseSystem.name] }\n\n/**\n * The heroes pack: what makes a game a classic hero RTS, opted into (`Rules.packs: [heroesPack()]`). Heroes, with\n * their experience, levels, points and abilities to learn, brought back at an altar (`revive`) or bought back\n * (`buyback`), their kills shared with those who assisted, their streaks paid for when they end (`HeroSettings`); creeps' camps that guard\n * their ground, sleep at night and come back (`Camp.respawn`); shops that sell (`buy`, `sell`) and places that hire\n * (`hire`). `rules` change its numbers (`HeroSettings`: how many heroes, the experience a level takes), the classic RTS numbers for\n * those left out. A game without it pays nothing for any of it: no hero is made of a hero's type, no command of these\n * is taken, no camp is looked at\n *\n * @public\n */\nexport function heroesPack(rules: Partial<HeroSettings> = {}): HeroesPack {\n\tfor (const key of Object.keys(rules)) if (!(key in defaultHeroSettings)) throw new Error(`\"${key}\" is not a rule of the heroes pack`)\n\treturn {\n\t\tid: HEROES,\n\t\toptions: rules,\n\t\tcallings: rules.callings ?? defaultHeroSettings.callings,\n\t\tsettings: () => ({ heroes: rules }),\n\t\tcommands: [...heroCommands] as unknown as CommandDef[],\n\t\tsystems: [campsComeBack],\n\t\thooks: heroHooks,\n\t\tlisteners: [...campListeners, ...assistListeners],\n\t\tcomponents: [fallen, assistLog, heroTally],\n\t\tstatFields: [heroGrowth]\n\t}\n}\n"],"mappings":"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"}