@v12-engine/engine 0.1.1 → 0.4.0

package/dist/orders/build.js

@@ -0,0 +1,278 @@
+import { closestPointOnRect, distToRect } from "../math.js";
+import { constructionOf, footprintOf } from "../defs.js";
+import { constructionFinished, worked } from "../engineEvents.js";
+import { constructionSite, underConstruction } from "../systems/construction.js";
+import { deposit, edgeDistance, moving } from "../entity.js";
+import { shortOf, spend } from "../player.js";
+import { engineMessage } from "../messages.js";
+import { faceTowards, halt, moveTo, moveToEntity, setAnchored, setGhost, walkOn } from "../systems/movement.js";
+import { footprintCell } from "../grid.js";
+import { unlocked } from "../tech.js";
+import { startProducing } from "../systems/production.js";
+//#region src/orders/build.ts
+/** Edge distance from which a worker can work on a building */
+var WORK_RANGE = .8;
+/** A builder that cannot get any closer than this because of units in the way starts building anyway */
+var CROWDED_RANGE = 3;
+/**
+* Ground a structure of this type covers when placed at `point`
+*
+* @beta
+*/
+function siteOf(def, point) {
+	const fp = footprintOf(def);
+	const cell = footprintCell(point.x, point.z, fp.w, fp.d);
+	return {
+		x: cell.x + fp.w / 2,
+		z: cell.z + fp.d / 2,
+		hw: fp.w / 2,
+		hd: fp.d / 2,
+		cellX: cell.x,
+		cellZ: cell.z
+	};
+}
+/**
+* Why this structure cannot be placed here right now, or undefined when it can. The ground has to be free,
+* then the `canPlace` hook has its say. With `fog`, ground the player has never seen counts as taken too:
+* that is for the player's own preview, which must not give away what is in the dark
+*
+* @beta
+*/
+function placementProblem(world, def, point, player, fog = false) {
+	const fp = footprintOf(def);
+	const site = siteOf(def, point);
+	if (def.builtOn !== void 0) {
+		const source = resourceAt(world, def, point);
+		if (!source) return engineMessage("buildOnResource", { resource: def.builtOn });
+		if (world.get(source.get(deposit).under)?.alive) return engineMessage("cannotBuildThere");
+	} else if (!world.grid.canPlace(site.cellX, site.cellZ, fp.w, fp.d)) return engineMessage("cannotBuildThere");
+	if (def.kind === "building" && world.nav.obstacleRoom() <= 0) return engineMessage("tooManyBuildings");
+	if (fog && player !== void 0) {
+		const { team } = world.player(player);
+		if (!(world.fog.isExplored(team, site.x - site.hw + .5, site.z - site.hd + .5) && world.fog.isExplored(team, site.x + site.hw - .5, site.z - site.hd + .5) && world.fog.isExplored(team, site.x - site.hw + .5, site.z + site.hd - .5) && world.fog.isExplored(team, site.x + site.hw - .5, site.z + site.hd - .5))) return engineMessage("cannotBuildThere");
+	}
+	if (!world.hooks.has("canPlace")) return void 0;
+	const event = world.hooks.run("canPlace", {
+		def,
+		site,
+		player,
+		cancelled: false
+	});
+	return event.cancelled ? event.reason ?? engineMessage("cannotBuildThere") : void 0;
+}
+var near = [];
+/**
+* The resource a building that goes up on one (`UnitTypeDef.builtOn`) would stand on when placed at `point`: one of its
+* kind that covers the very same ground. None where there is none
+*
+* @beta
+*/
+function resourceAt(world, def, point) {
+	if (def.builtOn === void 0) return void 0;
+	const site = siteOf(def, point);
+	for (const other of world.spatial.query(site.x, site.z, Math.max(site.hw, site.hd) + 1, near)) {
+		if (!other.alive || other.def.resource?.id !== def.builtOn || !other.cell) continue;
+		const fp = footprintOf(other.def);
+		if (other.cell.x === site.cellX && other.cell.z === site.cellZ && fp.w === site.hw * 2 && fp.d === site.hd * 2) return other;
+	}
+}
+/**
+* Which cells of the ground a structure would cover at `point` are in the way, row by row from its corner (`w` across,
+* `d` rows: `siteOf`'s cell first): taken (`free` says no), or not explored (`explored` says no, where it is asked).
+* What a preview draws cell by cell (RV88); `placementProblem` says the whole, the game's own say among it. None for a
+* structure built on a resource, whose ground is the resource's
+*
+* @beta
+*/
+function placementCells(def, point, free, explored) {
+	if (def.builtOn !== void 0) return void 0;
+	const { w, d } = footprintOf(def);
+	const { cellX, cellZ } = siteOf(def, point);
+	const blocked = [];
+	for (let z = cellZ; z < cellZ + d; z++) for (let x = cellX; x < cellX + w; x++) blocked.push(!free(x, z) || !!explored && !explored(x, z));
+	return blocked;
+}
+/**
+* Whether this structure can be placed here right now, see `placementProblem`
+*
+* @beta
+*/
+function canPlaceStructure(world, def, point, player, fog = false) {
+	return placementProblem(world, def, point, player, fog) === void 0;
+}
+var inside = [];
+/** Moves units standing on a construction site out of the way */
+function clearSite(world, site) {
+	world.spatial.query(site.x, site.z, Math.max(site.hw, site.hd) * 1.5 + 1, inside);
+	for (const unit of inside) {
+		if (!unit.get(moving) || unit.hidden || unit.flying) continue;
+		if (distToRect(unit.pos, site) >= unit.def.radius) continue;
+		const outside = closestPointOnRect(unit.pos, site, unit.def.radius + .3);
+		const point = world.nav.closestPoint(outside, 6) ?? outside;
+		world.place(unit, point);
+		walkOn(world, unit);
+	}
+}
+function workOn(world, entity, building, state, dt) {
+	const site = building && underConstruction(building);
+	if (!site) return "done";
+	if (edgeDistance(entity, building) > WORK_RANGE) {
+		moveToEntity(world, entity, building, WORK_RANGE * .5);
+		return "running";
+	}
+	if (entity.get(moving).status === "moving") halt(world, entity);
+	setAnchored(world, entity, true);
+	faceTowards(world, entity, building.pos, dt);
+	site.builders++;
+	const hammer = (state.hammer ?? HAMMER_INTERVAL * .5) - dt;
+	if (hammer <= 0) world.events.emit(worked, {
+		worker: entity,
+		target: building
+	});
+	state.hammer = hammer <= 0 ? hammer + HAMMER_INTERVAL : hammer;
+	return "running";
+}
+/** Whether the ground lets a builder get within work of a site from where it is, its own side of it: units are not asked, and one that flies needs none */
+function canWalkTo(world, entity, site) {
+	if (entity.flying) return true;
+	const way = world.nav.findPath(entity.pos, closestPointOnRect(entity.pos, site, entity.def.radius + .15));
+	return !!way && distToRect(way[way.length - 1], site) - entity.def.radius <= WORK_RANGE;
+}
+var buildOrder = {
+	type: "build",
+	building: (order) => !!order.state.building,
+	accepts(world, entity, init) {
+		return !!init.point && !!init.unitType && !!entity.def.builds?.includes(init.unitType) && world.registry.units.has(init.unitType);
+	},
+	update(world, entity, order, dt) {
+		const { state } = order;
+		if (state.building) return workOn(world, entity, world.get(state.building), state, dt);
+		const def = world.registry.unit(order.init.unitType);
+		const site = siteOf(def, order.init.point);
+		const m = entity.get(moving);
+		const gap = distToRect(entity.pos, site) - entity.def.radius;
+		if (gap > WORK_RANGE) {
+			if (m.status === "moving") return "running";
+			if (!(state.walked && gap <= CROWDED_RANGE && canWalkTo(world, entity, site))) {
+				if (state.walked && (m.status === "failed" || m.status === "arrived")) {
+					if (!state.ghost) {
+						state.ghost = true;
+						setGhost(world, entity, true);
+						moveTo(world, entity, closestPointOnRect(entity.pos, site, entity.def.radius + .15), { range: .3 });
+						return "running";
+					}
+					world.message(entity.owner, engineMessage("cannotReachSite"));
+					return "failed";
+				}
+				state.walked = true;
+				moveTo(world, entity, closestPointOnRect(entity.pos, site, entity.def.radius + .15), { range: .3 });
+				return "running";
+			}
+		}
+		if (state.ghost) setGhost(world, entity, false);
+		if (!unlocked(world, entity.owner, "unit", def.id, def.requires)) return "failed";
+		const problem = placementProblem(world, def, order.init.point, entity.owner);
+		if (problem) {
+			world.message(entity.owner, problem);
+			return "failed";
+		}
+		const made = startProducing(world, entity, "structure", def.id, def.cost, def.buildTime ?? 1);
+		if (!made) return "failed";
+		halt(world, entity);
+		clearSite(world, site);
+		const how = constructionOf(def);
+		const building = world.spawn(def.id, entity.owner, order.init.point, how === "instant" ? {} : { underConstruction: {
+			buildTime: made.time,
+			paid: made.cost
+		} });
+		state.building = building.id;
+		if (how === "instant") world.events.emit(constructionFinished, building);
+		return how === "builder" ? "running" : "done";
+	},
+	end(world, entity, order) {
+		setAnchored(world, entity, false);
+		if (order.state.ghost) setGhost(world, entity, false);
+	}
+};
+/** Work on an existing construction site: resuming an abandoned one or helping another builder */
+var constructOrder = {
+	type: "construct",
+	accepts(world, entity, init) {
+		const target = world.get(init.target);
+		return !!entity.def.builds?.length && !!target?.has(constructionSite) && constructionOf(target.def) === "builder" && world.areAllies(entity.owner, target.owner);
+	},
+	update(world, entity, order, dt) {
+		return workOn(world, entity, world.get(order.init.target), order.state, dt);
+	},
+	end(world, entity) {
+		setAnchored(world, entity, false);
+	}
+};
+/** Mending a building from nothing takes this much longer than building it did */
+var REPAIR_TIME = 1.5;
+/** Seconds between two blows of the hammer */
+var HAMMER_INTERVAL = 1;
+/**
+* Whether a worker of the player could mend it
+*
+* @beta
+*/
+function canRepair(world, player, target) {
+	return target.isBuilding && target.operational && target.health < target.maxHealth && world.areAllies(player, target.owner);
+}
+/** Mend a damaged building. It is paid for as the work goes on */
+var repairOrder = {
+	type: "repair",
+	accepts(world, entity, init) {
+		const target = world.get(init.target);
+		return !!entity.def.builds?.length && !!entity.get(moving) && !!target && canRepair(world, entity.owner, target);
+	},
+	update(world, entity, order, dt) {
+		const { state } = order;
+		const target = world.get(order.init.target);
+		if (!target || !canRepair(world, entity.owner, target)) return "done";
+		if (edgeDistance(entity, target) > WORK_RANGE) {
+			if (entity.get(moving).status === "failed" && state.walked) return "failed";
+			state.walked = true;
+			moveToEntity(world, entity, target, WORK_RANGE * .5);
+			return "running";
+		}
+		if (entity.get(moving).status === "moving") halt(world, entity);
+		setAnchored(world, entity, true);
+		faceTowards(world, entity, target.pos, dt);
+		const time = (target.def.buildTime ?? 20) * REPAIR_TIME;
+		const mended = Math.min(target.maxHealth / time * dt, target.maxHealth - target.health);
+		const part = mended / target.maxHealth * world.settings.economy.repairCost;
+		const purse = world.player(entity.owner).resources;
+		const owed = state.owed ??= {};
+		const due = {};
+		for (const kind in target.def.cost) {
+			owed[kind] = (owed[kind] ?? 0) + target.def.cost[kind] * part;
+			due[kind] = Math.floor(owed[kind]);
+		}
+		const short = shortOf(purse, due);
+		if (short) {
+			world.message(entity.owner, engineMessage("notEnough", { resource: short }));
+			return "failed";
+		}
+		spend(world, entity.owner, due, "repair", target.def.id);
+		for (const kind in due) owed[kind] -= due[kind];
+		target.health += mended;
+		state.hammer = (state.hammer ?? HAMMER_INTERVAL * .5) - dt;
+		if (state.hammer <= 0) {
+			state.hammer += HAMMER_INTERVAL;
+			world.events.emit(worked, {
+				worker: entity,
+				target
+			});
+		}
+		return target.health >= target.maxHealth ? "done" : "running";
+	},
+	end(world, entity) {
+		setAnchored(world, entity, false);
+	}
+};
+//#endregion
+export { buildOrder, canPlaceStructure, canRepair, constructOrder, placementCells, placementProblem, repairOrder, resourceAt, siteOf };
+
+//# sourceMappingURL=build.js.map

package/dist/orders/build.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"build.js","names":["workedEvent"],"sources":["../../src/orders/build.ts"],"sourcesContent":["import { constructionFinished, worked as workedEvent } from '#engine/engineEvents'\nimport { constructionOf, type Cost, footprintOf, type UnitTypeDef } from '#engine/defs'\nimport { constructionSite, underConstruction } from '#engine/systems/construction'\nimport { edgeDistance, type Entity, type EntityId, type PlayerId } from '#engine/entity'\nimport { closestPointOnRect, distToRect, type Rect, type Vec2 } from '#engine/math'\nimport type { OrderBehavior, OrderInits, OrderStatus } from '#engine/registry'\nimport { faceTowards, halt, moveTo, moveToEntity, setAnchored, setGhost, walkOn } from '#engine/systems/movement'\nimport { footprintCell } from '#engine/grid'\nimport { shortOf, spend } from '#engine/player'\nimport { startProducing } from '#engine/systems/production'\nimport { unlocked } from '#engine/tech'\nimport type { World } from '#engine/world'\nimport { engineMessage, type MessageRef } from '#engine/messages'\nimport { moving, deposit } from '../entity'\n\n/** Edge distance from which a worker can work on a building */\nconst WORK_RANGE = 0.8\n/** A builder that cannot get any closer than this because of units in the way starts building anyway */\nconst CROWDED_RANGE = 3\n\n/**\n * Ground a structure of this type covers when placed at `point`\n *\n * @beta\n */\nexport function siteOf(def: UnitTypeDef, point: Vec2): Rect & { cellX: number; cellZ: number } {\n\tconst fp = footprintOf(def)\n\tconst cell = footprintCell(point.x, point.z, fp.w, fp.d)\n\treturn { x: cell.x + fp.w / 2, z: cell.z + fp.d / 2, hw: fp.w / 2, hd: fp.d / 2, cellX: cell.x, cellZ: cell.z }\n}\n\n/**\n * Why this structure cannot be placed here right now, or undefined when it can. The ground has to be free,\n * then the `canPlace` hook has its say. With `fog`, ground the player has never seen counts as taken too:\n * that is for the player's own preview, which must not give away what is in the dark\n *\n * @beta\n */\nexport function placementProblem(world: World, def: UnitTypeDef, point: Vec2, player?: PlayerId, fog = false): MessageRef | undefined {\n\tconst fp = footprintOf(def)\n\tconst site = siteOf(def, point)\n\tif (def.builtOn !== undefined) {\n\t\t// over a resource of its kind, one nothing stands on yet: its ground is the resource's\n\t\tconst source = resourceAt(world, def, point)\n\t\tif (!source) return engineMessage('buildOnResource', { resource: def.builtOn })\n\t\tif (world.get(source.get(deposit)!.under)?.alive) return engineMessage('cannotBuildThere')\n\t} else if (!world.grid.canPlace(site.cellX, site.cellZ, fp.w, fp.d)) return engineMessage('cannotBuildThere')\n\t// what is built is in the way of who walks: where the navigation has no room for it, nothing more is built\n\tif (def.kind === 'building' && world.nav.obstacleRoom() <= 0) return engineMessage('tooManyBuildings')\n\tif (fog && player !== undefined) {\n\t\tconst { team } = world.player(player)\n\t\tconst explored =\n\t\t\tworld.fog.isExplored(team, site.x - site.hw + 0.5, site.z - site.hd + 0.5) &&\n\t\t\tworld.fog.isExplored(team, site.x + site.hw - 0.5, site.z - site.hd + 0.5) &&\n\t\t\tworld.fog.isExplored(team, site.x - site.hw + 0.5, site.z + site.hd - 0.5) &&\n\t\t\tworld.fog.isExplored(team, site.x + site.hw - 0.5, site.z + site.hd - 0.5)\n\t\tif (!explored) return engineMessage('cannotBuildThere')\n\t}\n\tif (!world.hooks.has('canPlace')) return undefined\n\tconst event = world.hooks.run('canPlace', { def, site, player, cancelled: false })\n\treturn event.cancelled ? (event.reason ?? engineMessage('cannotBuildThere')) : undefined\n}\n\nconst near: Entity[] = []\n\n/**\n * The resource a building that goes up on one (`UnitTypeDef.builtOn`) would stand on when placed at `point`: one of its\n * kind that covers the very same ground. None where there is none\n *\n * @beta\n */\nexport function resourceAt(world: World, def: UnitTypeDef, point: Vec2): Entity | undefined {\n\tif (def.builtOn === undefined) return undefined\n\tconst site = siteOf(def, point)\n\tfor (const other of world.spatial.query(site.x, site.z, Math.max(site.hw, site.hd) + 1, near)) {\n\t\tif (!other.alive || other.def.resource?.id !== def.builtOn || !other.cell) continue\n\t\tconst fp = footprintOf(other.def)\n\t\tif (other.cell.x === site.cellX && other.cell.z === site.cellZ && fp.w === site.hw * 2 && fp.d === site.hd * 2) return other\n\t}\n\treturn undefined\n}\n\n/**\n * Which cells of the ground a structure would cover at `point` are in the way, row by row from its corner (`w` across,\n * `d` rows: `siteOf`'s cell first): taken (`free` says no), or not explored (`explored` says no, where it is asked).\n * What a preview draws cell by cell (RV88); `placementProblem` says the whole, the game's own say among it. None for a\n * structure built on a resource, whose ground is the resource's\n *\n * @beta\n */\nexport function placementCells(\n\tdef: UnitTypeDef,\n\tpoint: Vec2,\n\tfree: (cellX: number, cellZ: number) => boolean,\n\texplored?: (cellX: number, cellZ: number) => boolean\n): boolean[] | undefined {\n\tif (def.builtOn !== undefined) return undefined\n\tconst { w, d } = footprintOf(def)\n\tconst { cellX, cellZ } = siteOf(def, point)\n\tconst blocked: boolean[] = []\n\tfor (let z = cellZ; z < cellZ + d; z++) for (let x = cellX; x < cellX + w; x++) blocked.push(!free(x, z) || (!!explored && !explored(x, z)))\n\treturn blocked\n}\n\n/**\n * Whether this structure can be placed here right now, see `placementProblem`\n *\n * @beta\n */\nexport function canPlaceStructure(world: World, def: UnitTypeDef, point: Vec2, player?: PlayerId, fog = false): boolean {\n\treturn placementProblem(world, def, point, player, fog) === undefined\n}\n\nconst inside: Entity[] = []\n\n/** Moves units standing on a construction site out of the way */\nfunction clearSite(world: World, site: Rect): void {\n\tworld.spatial.query(site.x, site.z, Math.max(site.hw, site.hd) * 1.5 + 1, inside)\n\tfor (const unit of inside) {\n\t\tif (!unit.get(moving) || unit.hidden || unit.flying) continue\n\t\tif (distToRect(unit.pos, site) >= unit.def.radius) continue\n\t\tconst outside = closestPointOnRect(unit.pos, site, unit.def.radius + 0.3)\n\t\tconst point = world.nav.closestPoint(outside, 6) ?? outside\n\t\tworld.place(unit, point)\n\t\t// teleporting drops the path\n\t\twalkOn(world, unit)\n\t}\n}\n\nfunction workOn(world: World, entity: Entity, building: Entity | undefined, state: WorkState, dt: number): OrderStatus {\n\tconst site = building && underConstruction(building)\n\tif (!site) return 'done'\n\tif (edgeDistance(entity, building) > WORK_RANGE) {\n\t\tmoveToEntity(world, entity, building, WORK_RANGE * 0.5)\n\t\treturn 'running'\n\t}\n\tif (entity.get(moving)!.status === 'moving') halt(world, entity)\n\tsetAnchored(world, entity, true)\n\tfaceTowards(world, entity, building.pos, dt)\n\tsite.builders++\n\t// a blow of its hammer now and then, for the screen (`worked`), as a repair has\n\tconst hammer = (state.hammer ?? HAMMER_INTERVAL * 0.5) - dt\n\tif (hammer <= 0) world.events.emit(workedEvent, { worker: entity, target: building })\n\tstate.hammer = hammer <= 0 ? hammer + HAMMER_INTERVAL : hammer\n\treturn 'running'\n}\n\n/**\n * What `construct` keeps: the seconds to its builder's next blow of the hammer\n *\n * @beta\n */\nexport interface WorkState {\n\t/** Seconds to its next blow, for the screen (`worked`) */\n\thammer?: number\n}\n\n/**\n * What `build` keeps: whether it walked to the site already, and the building once it is put down\n *\n * @beta\n */\nexport interface BuildState extends WorkState {\n\t/** It walked to the site already */\n\twalked?: boolean\n\t/** It walks through the others: its walk to the site failed once, held up among them (workers round a mine) */\n\tghost?: boolean\n\t/** The building, once it is put down */\n\tbuilding?: EntityId\n}\n\n/**\n * What `repair` keeps: whether it walked to it already, what of the cost it still owes, the seconds to its next swing\n *\n * @beta\n */\nexport interface RepairState {\n\t/** It walked to it already */\n\twalked?: boolean\n\t/** What of the cost of the repair it owes still */\n\towed?: Cost\n\t/** Seconds to its next swing */\n\thammer?: number\n}\n\n/** Whether the ground lets a builder get within work of a site from where it is, its own side of it: units are not asked, and one that flies needs none */\nfunction canWalkTo(world: World, entity: Entity, site: Rect): boolean {\n\tif (entity.flying) return true\n\tconst way = world.nav.findPath(entity.pos, closestPointOnRect(entity.pos, site, entity.def.radius + 0.15))\n\treturn !!way && distToRect(way[way.length - 1], site) - entity.def.radius <= WORK_RANGE\n}\n\nexport const buildOrder: OrderBehavior<BuildState, OrderInits['build']> = {\n\ttype: 'build',\n\tbuilding: (order) => !!order.state.building,\n\taccepts(world, entity, init) {\n\t\treturn !!init.point && !!init.unitType && !!entity.def.builds?.includes(init.unitType) && world.registry.units.has(init.unitType)\n\t},\n\tupdate(world, entity, order, dt) {\n\t\tconst { state } = order\n\t\tif (state.building) return workOn(world, entity, world.get(state.building), state, dt)\n\n\t\tconst def = world.registry.unit(order.init.unitType!)\n\t\tconst site = siteOf(def, order.init.point!)\n\t\tconst m = entity.get(moving)!\n\n\t\tconst gap = distToRect(entity.pos, site) - entity.def.radius\n\t\tif (gap > WORK_RANGE) {\n\t\t\tif (m.status === 'moving') return 'running'\n\t\t\t// held up right in front of it by units standing on the site: close enough, they get moved aside. Not by a cliff or a wood\n\t\t\tconst crowded = state.walked && gap <= CROWDED_RANGE && canWalkTo(world, entity, site)\n\t\t\tif (!crowded) {\n\t\t\t\t// `arrived` too: a walk stalled near its point counts as there, and here it was not near enough\n\t\t\t\tif (state.walked && (m.status === 'failed' || m.status === 'arrived')) {\n\t\t\t\t\t// held up among others (the workers anchored round a mine): once more, walking through them, as a hauling worker does\n\t\t\t\t\tif (!state.ghost) {\n\t\t\t\t\t\tstate.ghost = true\n\t\t\t\t\t\tsetGhost(world, entity, true)\n\t\t\t\t\t\tmoveTo(world, entity, closestPointOnRect(entity.pos, site, entity.def.radius + 0.15), { range: 0.3 })\n\t\t\t\t\t\treturn 'running'\n\t\t\t\t\t}\n\t\t\t\t\tworld.message(entity.owner, engineMessage('cannotReachSite'))\n\t\t\t\t\treturn 'failed'\n\t\t\t\t}\n\t\t\t\tstate.walked = true\n\t\t\t\tmoveTo(world, entity, closestPointOnRect(entity.pos, site, entity.def.radius + 0.15), { range: 0.3 })\n\t\t\t\treturn 'running'\n\t\t\t}\n\t\t}\n\n\t\tif (state.ghost) setGhost(world, entity, false)\n\t\tif (!unlocked(world, entity.owner, 'unit', def.id, def.requires)) return 'failed'\n\t\tconst problem = placementProblem(world, def, order.init.point!, entity.owner)\n\t\tif (problem) {\n\t\t\tworld.message(entity.owner, problem)\n\t\t\treturn 'failed'\n\t\t}\n\t\tconst made = startProducing(world, entity, 'structure', def.id, def.cost, def.buildTime ?? 1)\n\t\tif (!made) return 'failed'\n\t\thalt(world, entity)\n\t\tclearSite(world, site)\n\t\tconst how = constructionOf(def)\n\t\t// what appears at once is whole: no site, no builders\n\t\tconst building = world.spawn(\n\t\t\tdef.id,\n\t\t\tentity.owner,\n\t\t\torder.init.point!,\n\t\t\thow === 'instant' ? {} : { underConstruction: { buildTime: made.time, paid: made.cost } }\n\t\t)\n\t\tstate.building = building.id\n\t\t// what is there at once is built as it is put down\n\t\tif (how === 'instant') world.events.emit(constructionFinished, building)\n\t\t// what goes up on its own, or is there at once, leaves its builder free\n\t\treturn how === 'builder' ? 'running' : 'done'\n\t},\n\tend(world, entity, order) {\n\t\tsetAnchored(world, entity, false)\n\t\tif (order.state.ghost) setGhost(world, entity, false)\n\t}\n}\n\n/** Work on an existing construction site: resuming an abandoned one or helping another builder */\nexport const constructOrder: OrderBehavior<WorkState, OrderInits['construct']> = {\n\ttype: 'construct',\n\taccepts(world, entity, init) {\n\t\tconst target = world.get(init.target)\n\t\treturn (\n\t\t\t!!entity.def.builds?.length &&\n\t\t\t!!target?.has(constructionSite) &&\n\t\t\tconstructionOf(target.def) === 'builder' &&\n\t\t\tworld.areAllies(entity.owner, target.owner)\n\t\t)\n\t},\n\tupdate(world, entity, order, dt) {\n\t\treturn workOn(world, entity, world.get(order.init.target), order.state, dt)\n\t},\n\tend(world, entity) {\n\t\tsetAnchored(world, entity, false)\n\t}\n}\n\n/** Mending a building from nothing takes this much longer than building it did */\nconst REPAIR_TIME = 1.5\n/** Seconds between two blows of the hammer */\nconst HAMMER_INTERVAL = 1\n\n/**\n * Whether a worker of the player could mend it\n *\n * @beta\n */\nexport function canRepair(world: World, player: number, target: Entity): boolean {\n\treturn target.isBuilding && target.operational && target.health < target.maxHealth && world.areAllies(player, target.owner)\n}\n\n/** Mend a damaged building. It is paid for as the work goes on */\nexport const repairOrder: OrderBehavior<RepairState, OrderInits['repair']> = {\n\ttype: 'repair',\n\taccepts(world, entity, init) {\n\t\tconst target = world.get(init.target)\n\t\treturn !!entity.def.builds?.length && !!entity.get(moving) && !!target && canRepair(world, entity.owner, target)\n\t},\n\tupdate(world, entity, order, dt) {\n\t\tconst { state } = order\n\t\tconst target = world.get(order.init.target)\n\t\tif (!target || !canRepair(world, entity.owner, target)) return 'done'\n\t\tif (edgeDistance(entity, target) > WORK_RANGE) {\n\t\t\tif (entity.get(moving)!.status === 'failed' && state.walked) return 'failed'\n\t\t\tstate.walked = true\n\t\t\tmoveToEntity(world, entity, target, WORK_RANGE * 0.5)\n\t\t\treturn 'running'\n\t\t}\n\t\tif (entity.get(moving)!.status === 'moving') halt(world, entity)\n\t\tsetAnchored(world, entity, true)\n\t\tfaceTowards(world, entity, target.pos, dt)\n\n\t\tconst time = (target.def.buildTime ?? 20) * REPAIR_TIME\n\t\tconst mended = Math.min((target.maxHealth / time) * dt, target.maxHealth - target.health)\n\t\tconst part = (mended / target.maxHealth) * world.settings.economy.repairCost\n\t\tconst purse = world.player(entity.owner).resources\n\t\t// what is owed adds up until it is a whole coin, log, or whatever the building cost\n\t\tconst owed: Cost = (state.owed ??= {})\n\t\tconst due: Cost = {}\n\t\tfor (const kind in target.def.cost) {\n\t\t\towed[kind] = (owed[kind] ?? 0) + target.def.cost[kind] * part\n\t\t\tdue[kind] = Math.floor(owed[kind])\n\t\t}\n\t\tconst short = shortOf(purse, due)\n\t\tif (short) {\n\t\t\tworld.message(entity.owner, engineMessage('notEnough', { resource: short }))\n\t\t\treturn 'failed'\n\t\t}\n\t\tspend(world, entity.owner, due, 'repair', target.def.id)\n\t\tfor (const kind in due) owed[kind] -= due[kind]\n\t\ttarget.health += mended\n\n\t\tstate.hammer = (state.hammer ?? HAMMER_INTERVAL * 0.5) - dt\n\t\tif (state.hammer <= 0) {\n\t\t\tstate.hammer += HAMMER_INTERVAL\n\t\t\tworld.events.emit(workedEvent, { worker: entity, target })\n\t\t}\n\t\treturn target.health >= target.maxHealth ? 'done' : 'running'\n\t},\n\tend(world, entity) {\n\t\tsetAnchored(world, entity, false)\n\t}\n}\n"],"mappings":"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"}

package/dist/orders/cast.d.ts

@@ -1,4 +1,4 @@
-import { type AbilityDef } from '#engine/defs';
+import { type AbilityDef, type EffectDef } from '#engine/defs';
 import { type Entity, type ItemInstance } from '#engine/entity';
 import { type Vec2 } from '#engine/math';
 import type { OrderBehavior, OrderInits } from '#engine/registry';
@@ -47,12 +47,19 @@ export declare function notReady(world: World, entity: Entity, ability: AbilityD
  * 2. the caster pays, the cooldown starts, and one of its charges is spent where it has them;
  * 3. the effects of the ability happen;
  * 4. the `afterCast` hook, for what follows: the caster's passives that react to its casts.
+ *
+ * `held`: for an ability held and let go (`AbilityDef.hold`), how full it was (`EffectContext.held`), and the effects that
+ * go off in place of its own (a tap's)
  */
-export declare function fire(world: World, caster: Entity, ability: AbilityDef, target: Entity | undefined, item?: ItemInstance): void;
+export declare function fire(world: World, caster: Entity, ability: AbilityDef, target: Entity | undefined, item?: ItemInstance, held?: {
+    share: number;
+    effects?: EffectDef[];
+}): void;
 /**
  * Casts what goes off on the spot without the caster dropping what it is doing: a hero drinks a potion while it walks,
  * and leaps in the middle of a run. `point` is where it is aimed, for what goes off towards somewhere.
- * False when it cannot be cast this way, and takes an order
+ * False when it cannot be cast this way, and takes an order. What the rules refuse as an order (`beforeOrder`) they
+ * refuse here too: it is not cast, and true is returned
  */
 export declare function castAside(world: World, caster: Entity, from: {
     ability?: string;
@@ -88,12 +95,15 @@ export declare const castOrder: OrderBehavior<CastState, OrderInits['cast']>;
 export interface CastChannel {
     /** The ability, and its level */
     ability: string;
+    /** The level of the ability being channelled */
     level: number;
     /** What it is aimed at, and where */
     target?: number;
+    /** The world point the channel is aimed at (the target's position, or the point cast at) */
     point: Vec2;
     /** Seconds still to go, and gone */
     left: number;
+    /** Seconds the channel has already gone on */
     elapsed: number;
     /** Over: kept up to its end, or broken off */
     done?: boolean;