@v12-engine/engine 0.1.1 → 0.4.0

package/dist/abilities/screen.d.ts

@@ -0,0 +1,6 @@
+/**
+ * The areas of abilities on the ground the player is told of (`Snapshot.areas`): zones for their life and delayed
+ * blasts until they go off, with their shape, their place and the seconds left; their side's, and others' where the
+ * player sees them. None to a computer
+ */
+export declare const areasPart: import("..").SnapshotField<keyof import("..").Snapshot>;

package/dist/abilities/screen.js

@@ -0,0 +1,83 @@
+import { lowerChain } from "../defs.js";
+import { snapshotField } from "../replication.js";
+import { effectIndex, effectOfList } from "./effectIndex.js";
+import { effectArea } from "./shapes.js";
+import { zoneContext } from "./effects.js";
+//#region src/abilities/screen.ts
+/**
+* What the screens are told of abilities for their looks (E2E-PLAN AB19): the areas on the ground that last
+* (`Snapshot.areas`: a zone for its life, a delayed blast until it goes off), with their shape and time
+*/
+/** What a list of effects covers where it lands, for the screen: the first of its effects with an area */
+function listArea(context, effects) {
+	for (const effect of lowerChain(effects)) {
+		const area = effectArea(context, effect);
+		if (area) return area;
+	}
+}
+/** Rounded for the screen: a hundredth of a cell is nothing to see */
+var r = (n) => Math.round(n * 100) / 100;
+/**
+* The areas of abilities on the ground the player is told of (`Snapshot.areas`): zones for their life and delayed
+* blasts until they go off, with their shape, their place and the seconds left; their side's, and others' where the
+* player sees them. None to a computer
+*/
+var areasPart = snapshotField("areas", (view) => {
+	if (view.forComputer) return void 0;
+	const { world } = view;
+	if (!world.zones.length && !world.delayed.length) return void 0;
+	const areas = [];
+	const tell = (kind, context, shape, left, effect, extra) => {
+		const { caster, ability, level } = context;
+		const ours = view.isAlly(caster.owner);
+		if (!ours && !view.sees(shape.x, shape.z) && !view.sees(context.point.x, context.point.z)) return;
+		const index = effect && effectIndex(ability, effect);
+		areas.push({
+			kind,
+			ability: ability.id,
+			level,
+			...index !== void 0 && { effect: index },
+			...view.knows(caster) && { source: caster.id },
+			shape: shape.shape,
+			x: r(shape.x),
+			z: r(shape.z),
+			heading: r(shape.heading),
+			radius: r(shape.radius),
+			...shape.length && { length: r(shape.length) },
+			...shape.width && { width: r(shape.width) },
+			...shape.angle && { angle: r(shape.angle) },
+			left: r(left),
+			...ours && { ours },
+			...extra
+		});
+	};
+	for (const zone of world.zones) {
+		const context = zoneContext(world, zone);
+		const area = effectArea(context, zone.effect) ?? listArea(context, zone.effect.effects ?? []);
+		if (!area) continue;
+		tell("zone", context, area, zone.left, zone.effect, {
+			id: zone.id,
+			...zone.follows !== void 0 && { follows: zone.follows }
+		});
+	}
+	for (const entry of world.delayed) {
+		const { caster, ability, level, point, from, heading } = entry;
+		const context = {
+			world,
+			caster,
+			ability,
+			level,
+			point,
+			...from && { origin: from },
+			...heading !== void 0 && { heading }
+		};
+		const area = listArea(context, entry.effects);
+		if (!area) continue;
+		tell("delayed", context, area, entry.left, effectOfList(ability, entry.effects), entry.impact ? { impact: entry.impact } : {});
+	}
+	return areas.length ? areas : void 0;
+});
+//#endregion
+export { areasPart };
+
+//# sourceMappingURL=screen.js.map

package/dist/abilities/screen.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"screen.js","names":[],"sources":["../../src/abilities/screen.ts"],"sourcesContent":["/**\n * What the screens are told of abilities for their looks (E2E-PLAN AB19): the areas on the ground that last\n * (`Snapshot.areas`: a zone for its life, a delayed blast until it goes off), with their shape and time\n */\nimport { type EffectDef, type EffectShape, lowerChain } from '#engine/defs'\nimport { snapshotField } from '../replication'\nimport type { AreaState } from '../session/protocol'\nimport { type EffectContext, zoneContext } from './effects'\nimport { effectArea } from './shapes'\nimport { effectIndex, effectOfList } from './effectIndex'\n\n/** What a list of effects covers where it lands, for the screen: the first of its effects with an area */\nfunction listArea(context: EffectContext, effects: readonly EffectDef[]) {\n\tfor (const effect of lowerChain(effects)) {\n\t\tconst area = effectArea(context, effect)\n\t\tif (area) return area\n\t}\n\treturn undefined\n}\n\n/** Rounded for the screen: a hundredth of a cell is nothing to see */\nconst r = (n: number) => Math.round(n * 100) / 100\n\n/**\n * The areas of abilities on the ground the player is told of (`Snapshot.areas`): zones for their life and delayed\n * blasts until they go off, with their shape, their place and the seconds left; their side's, and others' where the\n * player sees them. None to a computer\n */\nexport const areasPart = snapshotField('areas', (view) => {\n\tif (view.forComputer) return undefined\n\tconst { world } = view\n\tif (!world.zones.length && !world.delayed.length) return undefined\n\tconst areas: AreaState[] = []\n\tconst tell = (\n\t\tkind: AreaState['kind'],\n\t\tcontext: EffectContext,\n\t\tshape: { shape: EffectShape; x: number; z: number; heading: number; radius: number; length: number; width: number; angle: number },\n\t\tleft: number,\n\t\teffect: EffectDef | undefined,\n\t\textra: Partial<AreaState>\n\t) => {\n\t\tconst { caster, ability, level } = context\n\t\tconst ours = view.isAlly(caster.owner)\n\t\tif (!ours && !view.sees(shape.x, shape.z) && !view.sees(context.point.x, context.point.z)) return\n\t\tconst index = effect && effectIndex(ability, effect)\n\t\tareas.push({\n\t\t\tkind,\n\t\t\tability: ability.id,\n\t\t\tlevel,\n\t\t\t...(index !== undefined && { effect: index }),\n\t\t\t...(view.knows(caster) && { source: caster.id }),\n\t\t\tshape: shape.shape,\n\t\t\tx: r(shape.x),\n\t\t\tz: r(shape.z),\n\t\t\theading: r(shape.heading),\n\t\t\tradius: r(shape.radius),\n\t\t\t...(shape.length && { length: r(shape.length) }),\n\t\t\t...(shape.width && { width: r(shape.width) }),\n\t\t\t...(shape.angle && { angle: r(shape.angle) }),\n\t\t\tleft: r(left),\n\t\t\t...(ours && { ours }),\n\t\t\t...extra\n\t\t})\n\t}\n\tfor (const zone of world.zones) {\n\t\tconst context = zoneContext(world, zone)\n\t\tconst area = effectArea(context, zone.effect) ?? listArea(context, zone.effect.effects ?? [])\n\t\tif (!area) continue\n\t\ttell('zone', context, area, zone.left, zone.effect, { id: zone.id, ...(zone.follows !== undefined && { follows: zone.follows }) })\n\t}\n\tfor (const entry of world.delayed) {\n\t\tconst { caster, ability, level, point, from, heading } = entry\n\t\tconst context: EffectContext = { world, caster, ability, level, point, ...(from && { origin: from }), ...(heading !== undefined && { heading }) }\n\t\tconst area = listArea(context, entry.effects)\n\t\tif (!area) continue\n\t\ttell('delayed', context, area, entry.left, effectOfList(ability, entry.effects), entry.impact ? { impact: entry.impact } : {})\n\t}\n\treturn areas.length ? areas : undefined\n})\n"],"mappings":";;;;;;;;;;;AAYA,SAAS,SAAS,SAAwB,SAA+B;CACxE,KAAK,MAAM,UAAU,WAAW,OAAO,GAAG;EACzC,MAAM,OAAO,WAAW,SAAS,MAAM;EACvC,IAAI,MAAM,OAAO;CAClB;AAED;;AAGA,IAAM,KAAK,MAAc,KAAK,MAAM,IAAI,GAAG,IAAI;;;;;;AAO/C,IAAa,YAAY,cAAc,UAAU,SAAS;CACzD,IAAI,KAAK,aAAa,OAAO,KAAA;CAC7B,MAAM,EAAE,UAAU;CAClB,IAAI,CAAC,MAAM,MAAM,UAAU,CAAC,MAAM,QAAQ,QAAQ,OAAO,KAAA;CACzD,MAAM,QAAqB,CAAC;CAC5B,MAAM,QACL,MACA,SACA,OACA,MACA,QACA,UACI;EACJ,MAAM,EAAE,QAAQ,SAAS,UAAU;EACnC,MAAM,OAAO,KAAK,OAAO,OAAO,KAAK;EACrC,IAAI,CAAC,QAAQ,CAAC,KAAK,KAAK,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,KAAK,KAAK,QAAQ,MAAM,GAAG,QAAQ,MAAM,CAAC,GAAG;EAC3F,MAAM,QAAQ,UAAU,YAAY,SAAS,MAAM;EACnD,MAAM,KAAK;GACV;GACA,SAAS,QAAQ;GACjB;GACA,GAAI,UAAU,KAAA,KAAa,EAAE,QAAQ,MAAM;GAC3C,GAAI,KAAK,MAAM,MAAM,KAAK,EAAE,QAAQ,OAAO,GAAG;GAC9C,OAAO,MAAM;GACb,GAAG,EAAE,MAAM,CAAC;GACZ,GAAG,EAAE,MAAM,CAAC;GACZ,SAAS,EAAE,MAAM,OAAO;GACxB,QAAQ,EAAE,MAAM,MAAM;GACtB,GAAI,MAAM,UAAU,EAAE,QAAQ,EAAE,MAAM,MAAM,EAAE;GAC9C,GAAI,MAAM,SAAS,EAAE,OAAO,EAAE,MAAM,KAAK,EAAE;GAC3C,GAAI,MAAM,SAAS,EAAE,OAAO,EAAE,MAAM,KAAK,EAAE;GAC3C,MAAM,EAAE,IAAI;GACZ,GAAI,QAAQ,EAAE,KAAK;GACnB,GAAG;EACJ,CAAC;CACF;CACA,KAAK,MAAM,QAAQ,MAAM,OAAO;EAC/B,MAAM,UAAU,YAAY,OAAO,IAAI;EACvC,MAAM,OAAO,WAAW,SAAS,KAAK,MAAM,KAAK,SAAS,SAAS,KAAK,OAAO,WAAW,CAAC,CAAC;EAC5F,IAAI,CAAC,MAAM;EACX,KAAK,QAAQ,SAAS,MAAM,KAAK,MAAM,KAAK,QAAQ;GAAE,IAAI,KAAK;GAAI,GAAI,KAAK,YAAY,KAAA,KAAa,EAAE,SAAS,KAAK,QAAQ;EAAG,CAAC;CAClI;CACA,KAAK,MAAM,SAAS,MAAM,SAAS;EAClC,MAAM,EAAE,QAAQ,SAAS,OAAO,OAAO,MAAM,YAAY;EACzD,MAAM,UAAyB;GAAE;GAAO;GAAQ;GAAS;GAAO;GAAO,GAAI,QAAQ,EAAE,QAAQ,KAAK;GAAI,GAAI,YAAY,KAAA,KAAa,EAAE,QAAQ;EAAG;EAChJ,MAAM,OAAO,SAAS,SAAS,MAAM,OAAO;EAC5C,IAAI,CAAC,MAAM;EACX,KAAK,WAAW,SAAS,MAAM,MAAM,MAAM,aAAa,SAAS,MAAM,OAAO,GAAG,MAAM,SAAS,EAAE,QAAQ,MAAM,OAAO,IAAI,CAAC,CAAC;CAC9H;CACA,OAAO,MAAM,SAAS,QAAQ,KAAA;AAC/B,CAAC"}

package/dist/abilities/shapes.d.ts

@@ -0,0 +1,66 @@
+/**
+ * The shapes of what an effect covers (E2E-PLAN AB10): a circle (its `radius`), a cone, a line, a rectangle, a ring, an
+ * arc and a cross, turned the way the ability was aimed, worked out where it lands (`effectArea`) and asked of each unit
+ * (`inArea`). `effectTargets` reads them for every effect, a zone for what is inside it
+ */
+import type { EffectDef, EffectShape } from '#engine/defs';
+import type { Entity } from '#engine/entity';
+import type { Vec2 } from '#engine/math';
+import type { EffectContext } from './effects';
+/**
+ * What an effect covers where it lands (`effectArea`): its shape, where it is laid and the way it faces, with its sizes
+ * worked out. A circle, a ring, a rectangle and a cross lie around the point it landed on; a cone, a line and an arc go
+ * off from where the effects do (the caster, or the context's `origin`)
+ *
+ * @beta
+ */
+export interface EffectArea {
+    /** Which shape it is: circle, cone, line, rect, ring, arc or cross (`EffectCommon.shape`) */
+    shape: EffectShape;
+    /** Where it is laid: its middle (circle, ring, rect, cross), or where it goes off from (cone, line, arc) */
+    x: number;
+    /** Where it is laid along z, as `x` is along x */
+    z: number;
+    /** The way it faces, as a unit's `facing` is (radians, 0 along +z) */
+    heading: number;
+    /** Of a circle, a ring and an arc: how far out it reaches */
+    radius: number;
+    /** Of a cone, a line, a rectangle and a cross: how long it is, end to end */
+    length: number;
+    /** Of a line, a rectangle and a cross: how far out it covers on either side; of a ring and an arc, how thick */
+    width: number;
+    /** Of a cone and an arc: how wide it opens, in radians */
+    angle: number;
+}
+/**
+ * The way the effects of a context face: its `heading` where it has one (a zone's, a missile's way), from where they go
+ * off from (`effectOrigin`) to where they landed otherwise, and the way the caster looks where those are one place
+ *
+ * @beta
+ */
+export declare function effectHeading(context: EffectContext): number;
+/**
+ * What an effect covers where it lands (`EffectCommon.shape`, its `radius`, `length`, `width` and `angle`, code asked as
+ * it lands): undefined for one that covers no area (no shape, and no radius), which is for its target alone. What a game's
+ * own effect asks to cover what the engine's would (`inArea` of each unit)
+ *
+ * @beta
+ */
+export declare function effectArea(context: EffectContext, effect: EffectDef): EffectArea | undefined;
+/**
+ * How far from where an area is laid (`EffectArea.x`, `z`) the farthest of it is: what to look for units within
+ *
+ * @beta
+ */
+export declare function areaReach(area: EffectArea): number;
+/**
+ * Whether something `radius` round at a place is in an area, any of it (`effectArea`): what an effect with a shape
+ * reaches
+ *
+ * @beta
+ */
+export declare function inArea(area: EffectArea, at: Vec2, radius?: number): boolean;
+/** How far round a unit is, for an area: its footprint's half, for a building */
+export declare const edgeRadius: (entity: Entity) => number;
+/** Whether an effect, or one it holds, covers an area of a shape other than a circle: what a zone and a delay keep the way of */
+export declare function shaped(effects: readonly EffectDef[] | undefined): boolean;

package/dist/abilities/shapes.js

@@ -0,0 +1,122 @@
+import { atan2, cos, hypot, sin } from "../exactMath.js";
+import { effectOrigin } from "./land.js";
+import { valueOf } from "./amounts.js";
+//#region src/abilities/shapes.ts
+/** The shapes that go off from where the effects go off from, rather than lie around where they landed */
+var FROM_ORIGIN = /* @__PURE__ */ new Set([
+	"cone",
+	"line",
+	"arc"
+]);
+/**
+* The way the effects of a context face: its `heading` where it has one (a zone's, a missile's way), from where they go
+* off from (`effectOrigin`) to where they landed otherwise, and the way the caster looks where those are one place
+*
+* @beta
+*/
+function effectHeading(context) {
+	if (context.heading !== void 0) return context.heading;
+	const from = effectOrigin(context);
+	const dx = context.point.x - from.x;
+	const dz = context.point.z - from.z;
+	return hypot(dx, dz) > .01 ? atan2(dx, dz) : context.caster.facing;
+}
+/**
+* What an effect covers where it lands (`EffectCommon.shape`, its `radius`, `length`, `width` and `angle`, code asked as
+* it lands): undefined for one that covers no area (no shape, and no radius), which is for its target alone. What a game's
+* own effect asks to cover what the engine's would (`inArea` of each unit)
+*
+* @beta
+*/
+function effectArea(context, effect) {
+	const fields = effect;
+	const radius = valueOf(context, fields.radius);
+	const shape = fields.shape ?? (radius ? "circle" : void 0);
+	if (!shape || shape === "circle" && !radius) return void 0;
+	const at = FROM_ORIGIN.has(shape) ? effectOrigin(context) : context.point;
+	return {
+		shape,
+		x: at.x,
+		z: at.z,
+		heading: shape === "circle" ? 0 : effectHeading(context),
+		radius,
+		length: valueOf(context, fields.length),
+		width: valueOf(context, fields.width, void 0, 1),
+		angle: valueOf(context, fields.angle)
+	};
+}
+/**
+* How far from where an area is laid (`EffectArea.x`, `z`) the farthest of it is: what to look for units within
+*
+* @beta
+*/
+function areaReach(area) {
+	switch (area.shape) {
+		case "circle":
+		case "ring":
+		case "arc": return area.radius;
+		case "cone": return area.length;
+		case "line": return hypot(area.length, area.width);
+		default: return hypot(area.length / 2, area.width);
+	}
+}
+/** How far a point is from a stretch along `heading`, `from` to `to` of the way, and `width` out on either side */
+function fromBand(area, at, heading, from, to) {
+	const dx = at.x - area.x;
+	const dz = at.z - area.z;
+	const s = sin(heading);
+	const c = cos(heading);
+	const along = dx * s + dz * c;
+	const across = Math.abs(dx * c - dz * s);
+	return hypot(Math.max(from - along, along - to, 0), Math.max(across - area.width, 0));
+}
+/** How far round from the way an area faces a point lies, either way: 0 to π */
+function turnFrom(heading, dx, dz) {
+	let turn = Math.abs(atan2(dx, dz) - heading) % (Math.PI * 2);
+	if (turn > Math.PI) turn = Math.PI * 2 - turn;
+	return turn;
+}
+/**
+* Whether something `radius` round at a place is in an area, any of it (`effectArea`): what an effect with a shape
+* reaches
+*
+* @beta
+*/
+function inArea(area, at, radius = 0) {
+	const dx = at.x - area.x;
+	const dz = at.z - area.z;
+	const far = hypot(dx, dz);
+	switch (area.shape) {
+		case "circle": return far - radius <= area.radius;
+		case "ring": return Math.max(area.radius - area.width - far, far - area.radius, 0) <= radius;
+		case "line": return fromBand(area, at, area.heading, 0, area.length) <= radius;
+		case "rect": return fromBand(area, at, area.heading, -area.length / 2, area.length / 2) <= radius;
+		case "cross": return fromBand(area, at, area.heading + Math.PI / 4, -area.length / 2, area.length / 2) <= radius || fromBand(area, at, area.heading - Math.PI / 4, -area.length / 2, area.length / 2) <= radius;
+		case "cone": {
+			if (far - radius > area.length) return false;
+			if (far <= radius) return true;
+			const past = turnFrom(area.heading, dx, dz) - area.angle / 2;
+			return past <= 0 || (past < Math.PI / 2 ? far * sin(past) : far) <= radius;
+		}
+		case "arc": {
+			const out = Math.max(area.radius - area.width - far, far - area.radius, 0);
+			const past = turnFrom(area.heading, dx, dz) - area.angle / 2;
+			const round = past <= 0 ? 0 : far * sin(Math.min(past, Math.PI / 2));
+			return hypot(out, round) <= radius;
+		}
+	}
+}
+/** How far round a unit is, for an area: its footprint's half, for a building */
+var edgeRadius = (entity) => entity.def.footprint ? Math.max(entity.def.footprint.w, entity.def.footprint.d) / 2 : entity.def.radius;
+/** Whether an effect, or one it holds, covers an area of a shape other than a circle: what a zone and a delay keep the way of */
+function shaped(effects) {
+	for (const effect of effects ?? []) {
+		const fields = effect;
+		if (fields.shape && fields.shape !== "circle" || shaped(fields.effects) || shaped(fields.onEnd) || shaped(fields.split) || shaped(fields.onWall)) return true;
+	}
+	return false;
+}
+//#endregion
+export { areaReach, edgeRadius, effectArea, effectHeading, inArea, shaped };
+
+//# sourceMappingURL=shapes.js.map

package/dist/abilities/shapes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shapes.js","names":[],"sources":["../../src/abilities/shapes.ts"],"sourcesContent":["/**\n * The shapes of what an effect covers (E2E-PLAN AB10): a circle (its `radius`), a cone, a line, a rectangle, a ring, an\n * arc and a cross, turned the way the ability was aimed, worked out where it lands (`effectArea`) and asked of each unit\n * (`inArea`). `effectTargets` reads them for every effect, a zone for what is inside it\n */\nimport type { AnyEffect, EffectDef, EffectShape } from '#engine/defs'\nimport type { Entity } from '#engine/entity'\nimport { atan2, cos, hypot, sin } from '#engine/exactMath'\nimport type { Vec2 } from '#engine/math'\nimport { valueOf } from './amounts'\nimport type { EffectContext } from './effects'\nimport { effectOrigin } from './land'\n\n/**\n * What an effect covers where it lands (`effectArea`): its shape, where it is laid and the way it faces, with its sizes\n * worked out. A circle, a ring, a rectangle and a cross lie around the point it landed on; a cone, a line and an arc go\n * off from where the effects do (the caster, or the context's `origin`)\n *\n * @beta\n */\nexport interface EffectArea {\n\t/** Which shape it is: circle, cone, line, rect, ring, arc or cross (`EffectCommon.shape`) */\n\tshape: EffectShape\n\t/** Where it is laid: its middle (circle, ring, rect, cross), or where it goes off from (cone, line, arc) */\n\tx: number\n\t/** Where it is laid along z, as `x` is along x */\n\tz: number\n\t/** The way it faces, as a unit's `facing` is (radians, 0 along +z) */\n\theading: number\n\t/** Of a circle, a ring and an arc: how far out it reaches */\n\tradius: number\n\t/** Of a cone, a line, a rectangle and a cross: how long it is, end to end */\n\tlength: number\n\t/** Of a line, a rectangle and a cross: how far out it covers on either side; of a ring and an arc, how thick */\n\twidth: number\n\t/** Of a cone and an arc: how wide it opens, in radians */\n\tangle: number\n}\n\n/** The shapes that go off from where the effects go off from, rather than lie around where they landed */\nconst FROM_ORIGIN: ReadonlySet<EffectShape> = new Set(['cone', 'line', 'arc'])\n\n/**\n * The way the effects of a context face: its `heading` where it has one (a zone's, a missile's way), from where they go\n * off from (`effectOrigin`) to where they landed otherwise, and the way the caster looks where those are one place\n *\n * @beta\n */\nexport function effectHeading(context: EffectContext): number {\n\tif (context.heading !== undefined) return context.heading\n\tconst from = effectOrigin(context)\n\tconst dx = context.point.x - from.x\n\tconst dz = context.point.z - from.z\n\treturn hypot(dx, dz) > 0.01 ? atan2(dx, dz) : context.caster.facing\n}\n\n/**\n * What an effect covers where it lands (`EffectCommon.shape`, its `radius`, `length`, `width` and `angle`, code asked as\n * it lands): undefined for one that covers no area (no shape, and no radius), which is for its target alone. What a game's\n * own effect asks to cover what the engine's would (`inArea` of each unit)\n *\n * @beta\n */\nexport function effectArea(context: EffectContext, effect: EffectDef): EffectArea | undefined {\n\tconst fields = effect as AnyEffect\n\tconst radius = valueOf(context, fields.radius)\n\tconst shape = fields.shape ?? (radius ? 'circle' : undefined)\n\tif (!shape || (shape === 'circle' && !radius)) return undefined\n\tconst at = FROM_ORIGIN.has(shape) ? effectOrigin(context) : context.point\n\treturn {\n\t\tshape,\n\t\tx: at.x,\n\t\tz: at.z,\n\t\theading: shape === 'circle' ? 0 : effectHeading(context),\n\t\tradius,\n\t\tlength: valueOf(context, fields.length),\n\t\twidth: valueOf(context, fields.width, undefined, 1),\n\t\tangle: valueOf(context, fields.angle)\n\t}\n}\n\n/**\n * How far from where an area is laid (`EffectArea.x`, `z`) the farthest of it is: what to look for units within\n *\n * @beta\n */\nexport function areaReach(area: EffectArea): number {\n\tswitch (area.shape) {\n\t\tcase 'circle':\n\t\tcase 'ring':\n\t\tcase 'arc':\n\t\t\treturn area.radius\n\t\tcase 'cone':\n\t\t\treturn area.length\n\t\tcase 'line':\n\t\t\treturn hypot(area.length, area.width)\n\t\tdefault:\n\t\t\treturn hypot(area.length / 2, area.width)\n\t}\n}\n\n/** How far a point is from a stretch along `heading`, `from` to `to` of the way, and `width` out on either side */\nfunction fromBand(area: EffectArea, at: Vec2, heading: number, from: number, to: number): number {\n\tconst dx = at.x - area.x\n\tconst dz = at.z - area.z\n\tconst s = sin(heading)\n\tconst c = cos(heading)\n\tconst along = dx * s + dz * c\n\tconst across = Math.abs(dx * c - dz * s)\n\treturn hypot(Math.max(from - along, along - to, 0), Math.max(across - area.width, 0))\n}\n\n/** How far round from the way an area faces a point lies, either way: 0 to π */\nfunction turnFrom(heading: number, dx: number, dz: number): number {\n\tlet turn = Math.abs(atan2(dx, dz) - heading) % (Math.PI * 2)\n\tif (turn > Math.PI) turn = Math.PI * 2 - turn\n\treturn turn\n}\n\n/**\n * Whether something `radius` round at a place is in an area, any of it (`effectArea`): what an effect with a shape\n * reaches\n *\n * @beta\n */\nexport function inArea(area: EffectArea, at: Vec2, radius = 0): boolean {\n\tconst dx = at.x - area.x\n\tconst dz = at.z - area.z\n\tconst far = hypot(dx, dz)\n\tswitch (area.shape) {\n\t\tcase 'circle':\n\t\t\treturn far - radius <= area.radius\n\t\tcase 'ring':\n\t\t\treturn Math.max(area.radius - area.width - far, far - area.radius, 0) <= radius\n\t\tcase 'line':\n\t\t\treturn fromBand(area, at, area.heading, 0, area.length) <= radius\n\t\tcase 'rect':\n\t\t\treturn fromBand(area, at, area.heading, -area.length / 2, area.length / 2) <= radius\n\t\tcase 'cross':\n\t\t\treturn (\n\t\t\t\tfromBand(area, at, area.heading + Math.PI / 4, -area.length / 2, area.length / 2) <= radius ||\n\t\t\t\tfromBand(area, at, area.heading - Math.PI / 4, -area.length / 2, area.length / 2) <= radius\n\t\t\t)\n\t\tcase 'cone': {\n\t\t\tif (far - radius > area.length) return false\n\t\t\tif (far <= radius) return true\n\t\t\tconst past = turnFrom(area.heading, dx, dz) - area.angle / 2\n\t\t\t// within its opening, or near enough to one of its sides\n\t\t\treturn past <= 0 || (past < Math.PI / 2 ? far * sin(past) : far) <= radius\n\t\t}\n\t\tcase 'arc': {\n\t\t\tconst out = Math.max(area.radius - area.width - far, far - area.radius, 0)\n\t\t\tconst past = turnFrom(area.heading, dx, dz) - area.angle / 2\n\t\t\tconst round = past <= 0 ? 0 : far * sin(Math.min(past, Math.PI / 2))\n\t\t\treturn hypot(out, round) <= radius\n\t\t}\n\t}\n}\n\n/** How far round a unit is, for an area: its footprint's half, for a building */\nexport const edgeRadius = (entity: Entity): number =>\n\tentity.def.footprint ? Math.max(entity.def.footprint.w, entity.def.footprint.d) / 2 : entity.def.radius\n\n/** Whether an effect, or one it holds, covers an area of a shape other than a circle: what a zone and a delay keep the way of */\nexport function shaped(effects: readonly EffectDef[] | undefined): boolean {\n\tfor (const effect of effects ?? []) {\n\t\tconst fields = effect as AnyEffect\n\t\tif ((fields.shape && fields.shape !== 'circle') || shaped(fields.effects) || shaped(fields.onEnd) || shaped(fields.split) || shaped(fields.onWall)) return true\n\t}\n\treturn false\n}\n"],"mappings":"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"}

package/dist/abilities/text.d.ts

@@ -1,10 +1,11 @@
-import { type AbilityDef, type BuffDef, type Scaled, type Scaling, type StatKey, type Stats } from '#engine/defs';
+import { type AbilityDef, type BuffDef, type EffectValue, type Scaled, type Scaling, type StatKey, type Stats } from '#engine/defs';
 /**
  * What the caster brings to an ability's numbers: its stats now, its level as a hero, and the attack damage of its own
  *
  * @beta
  */
 export interface CasterFacts {
+    /** The stats of the caster now, which the numbers of an ability scale from */
     stats: Readonly<Stats>;
     /** 1 for what is not a hero */
     heroLevel: number;
@@ -17,9 +18,11 @@ export interface CasterFacts {
  * @beta
  */
 export interface AbilityTextContext {
+    /** The ability the text is worked out for */
     ability: AbilityDef;
     /** The level of the ability: 1 for one that has no levels */
     level: number;
+    /** What the caster brings to the ability's numbers: its stats, hero level and own attack damage */
     caster: CasterFacts;
     /** A buff by id, for how long the ones the ability puts on last */
     buff?: (id: string) => BuffDef | undefined;
@@ -45,9 +48,11 @@ export interface ValuePart {
  * @beta
  */
 export interface AbilityValue {
+    /** The value in full: `base` and every part added up */
     total: number;
     /** What it is without the stats of the caster */
     base: number;
+    /** The stat-scaled parts of the value, one for each stat of the caster that adds to it */
     parts: ValuePart[];
     /** What follows the number: `s` for seconds, `%`. Nothing when left out */
     unit?: string;
@@ -72,10 +77,17 @@ export type TextSegment = string | {
     name: string;
     value: AbilityValue;
 };
+/**
+ * The value of an amount for an ability's text (`abilityValues`): at the level, or what its code says for the caster
+ * as it is, with no effect landing and no target
+ *
+ * @beta
+ */
+export declare function valueFor(value: EffectValue | undefined, level: number, caster: CasterFacts, fallback?: number): number;
 /**
  * The values of an ability at a level, for a caster, by name: its own (`AbilityDef.values`), and what its effects say
  * when it does not name them itself: `damage`, `heal`, `shield` and `amount` (the first effect of each kind with an
- * amount), `duration`, `radius`, `range`, `cooldown`, `charges` and `refill`, `mana`, `count` and `distance`
+ * amount), `duration`, `radius`, `chance` (in percent), `range`, `cooldown`, `charges` and `refill`, `mana`, `window` (a recast's), `count` and `distance`
  *
  * @beta
  */

package/dist/abilities/text.js

@@ -0,0 +1,204 @@
+import { anyEffect, at, innerEffects } from "../defs.js";
+//#region src/abilities/text.ts
+/**
+* An amount with what the stats of the caster add to it, and the parts that come from each: the same arithmetic as
+* the simulation (`scaled`)
+*
+* @internal
+*/
+function scaledParts(amount, scaling, level, caster) {
+	const parts = [];
+	let total = amount;
+	if (scaling) for (const key in scaling) {
+		const stat = key;
+		const ratio = at(scaling[stat], level);
+		if (!ratio) continue;
+		const part = (stat === "level" ? caster.heroLevel - 1 : stat === "bonusAttackDamage" ? Math.max(caster.stats.attackDamage - caster.ownAttackDamage, 0) : caster.stats[stat]) * ratio;
+		total += part;
+		parts.push({
+			stat,
+			ratio,
+			amount: part
+		});
+	}
+	return {
+		total,
+		base: amount,
+		parts
+	};
+}
+/**
+* The value of an amount for an ability's text (`abilityValues`): at the level, or what its code says for the caster
+* as it is, with no effect landing and no target
+*
+* @beta
+*/
+function valueFor(value, level, caster, fallback = 0) {
+	if (typeof value !== "function") return at(value, level, fallback);
+	return value({
+		level,
+		caster
+	});
+}
+/** The effects of an ability, those inside others (a missile's, a delay's) too, in order */
+function* allEffects(effects) {
+	for (const effect of effects ?? []) {
+		yield effect;
+		yield* allEffects(innerEffects(effect));
+	}
+}
+/**
+* The values of an ability at a level, for a caster, by name: its own (`AbilityDef.values`), and what its effects say
+* when it does not name them itself: `damage`, `heal`, `shield` and `amount` (the first effect of each kind with an
+* amount), `duration`, `radius`, `chance` (in percent), `range`, `cooldown`, `charges` and `refill`, `mana`, `window` (a recast's), `count` and `distance`
+*
+* @beta
+*/
+function abilityValues(ability, level, caster, buff) {
+	const values = /* @__PURE__ */ new Map();
+	const context = {
+		ability,
+		level,
+		caster,
+		buff,
+		value: (name) => values.get(name)
+	};
+	const plain = (total, unit) => ({
+		total,
+		base: total,
+		parts: [],
+		unit
+	});
+	const found = (name, value) => {
+		if (value && !values.has(name)) values.set(name, value);
+	};
+	for (const effect of [...allEffects([...ability.effects, ...ability.passive ?? []])].map(anyEffect)) {
+		if (effect.amount !== void 0 || effect.scaling) {
+			const value = scaledParts(valueFor(effect.amount, level, caster), effect.scaling, level, caster);
+			if (effect.type === "damage" || effect.type === "heal") found(effect.type, value);
+			found("amount", value);
+		}
+		if (effect.duration !== void 0) found("duration", plain(valueFor(effect.duration, level, caster), "s"));
+		else if (effect.buff && buff) {
+			const lasting = buff(effect.buff)?.duration;
+			if (lasting !== void 0) found("duration", plain(at(lasting, level), "s"));
+		}
+		if (effect.radius !== void 0) found("radius", plain(valueFor(effect.radius, level, caster)));
+		if (effect.chance !== void 0) found("chance", plain(valueFor(effect.chance, level, caster) * 100, "%"));
+		if (effect.count !== void 0) found("count", plain(at(effect.count, level)));
+		if (effect.distance !== void 0) found("distance", plain(at(effect.distance, level)));
+	}
+	if (ability.range !== void 0) found("range", plain(at(ability.range, level)));
+	if (ability.cooldown !== void 0) found("cooldown", plain(at(ability.cooldown, level), "s"));
+	if (ability.charges) {
+		found("charges", plain(at(ability.charges.count, level)));
+		found("refill", plain(at(ability.charges.refill, level), "s"));
+	}
+	if (ability.manaCost !== void 0) found("mana", plain(at(ability.manaCost, level)));
+	if (ability.recast) found("window", plain(at(ability.recast.window, level), "s"));
+	for (const [name, def] of Object.entries(ability.values ?? {})) {
+		let value;
+		if (typeof def === "function") {
+			const made = def(context);
+			value = typeof made === "number" ? plain(made) : made;
+		} else {
+			value = scaledParts(at(def.amount, level), def.scaling, level, caster);
+			if (def.percent) {
+				value = {
+					total: value.total * 100,
+					base: value.base * 100,
+					parts: value.parts.map((part) => ({
+						...part,
+						ratio: part.ratio * 100,
+						amount: part.amount * 100
+					}))
+				};
+				value.unit = "%";
+			}
+			if (def.unit) value.unit = def.unit;
+		}
+		values.set(name, value);
+	}
+	return values;
+}
+/**
+* What the ability says it does, for this caster now: its description with each `{value}` worked out (or its own
+* `describe`), as words and values. A name it has no value for is left as it is written, braces and all
+*
+* @beta
+*/
+function describeAbility(ability, level, caster, buff) {
+	const values = abilityValues(ability, level, caster, buff);
+	const context = {
+		ability,
+		level,
+		caster,
+		buff,
+		value: (name) => values.get(name)
+	};
+	const said = ability.describe ? ability.describe(context) : ability.description ?? "";
+	if (typeof said !== "string") return said;
+	const segments = [];
+	let from = 0;
+	for (const match of said.matchAll(/\{([a-zA-Z][\w.]*)\}/g)) {
+		const value = values.get(match[1]);
+		if (!value) continue;
+		if (match.index > from) segments.push(said.slice(from, match.index));
+		segments.push({
+			name: match[1],
+			value
+		});
+		from = match.index + match[0].length;
+	}
+	if (from < said.length) segments.push(said.slice(from));
+	return segments;
+}
+/**
+* How a stat is called in the text of an ability
+*
+* @beta
+*/
+var STAT_WORDS = {
+	abilityPower: "ability power",
+	attackDamage: "attack damage",
+	bonusAttackDamage: "bonus attack damage",
+	health: "max health",
+	mana: "max mana",
+	armor: "armor",
+	magicResist: "magic resist",
+	moveSpeed: "move speed",
+	attackSpeed: "attack speed",
+	level: "per level"
+};
+/**
+* A number as an ability's text shows it: whole, or with one decimal when it is small and has one
+*
+* @beta
+*/
+function formatNumber(value) {
+	const rounded = Math.abs(value) < 10 ? Math.round(value * 10) / 10 : Math.round(value);
+	return String(rounded);
+}
+/**
+* A value in words: `80`, or `80 (50 + 60% ability power)` when stats add to it
+*
+* @beta
+*/
+function valueText(value) {
+	const total = `${formatNumber(value.total)}${value.unit ?? ""}`;
+	if (value.parts.length === 0) return total;
+	const parts = value.parts.map((part) => part.stat === "level" ? `${formatNumber(part.ratio)} per level` : `${formatNumber(part.ratio * 100)}% ${STAT_WORDS[part.stat] ?? part.stat}`);
+	return `${total} (${[...value.base ? [formatNumber(value.base)] : [], ...parts].join(" + ")})`;
+}
+/**
+* The text of an ability as plain words: for a tooltip of words only, a log, a test
+*
+* @beta
+*/
+function abilityText(segments) {
+	return segments.map((segment) => typeof segment === "string" ? segment : valueText(segment.value)).join("");
+}
+//#endregion
+export { STAT_WORDS, abilityText, abilityValues, describeAbility, formatNumber, scaledParts, valueFor, valueText };
+
+//# sourceMappingURL=text.js.map

package/dist/abilities/text.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"text.js","names":[],"sources":["../../src/abilities/text.ts"],"sourcesContent":["import {\n\ttype AbilityDef,\n\tanyEffect,\n\tat,\n\ttype BuffDef,\n\ttype EffectDef,\n\tinnerEffects,\n\ttype EffectValue,\n\ttype EffectValueContext,\n\ttype Scaled,\n\ttype Scaling,\n\ttype StatKey,\n\ttype Stats\n} from '#engine/defs'\n\n/*\n * What an ability says it does, worked out for the one who has it: \"deals 80 (50 + 60% ability power)\", not \"deals\n * 50/100/150 plus 60% of ability power\". Its description is a template with values in braces (`{damage}`), each worked\n * out from the caster's stats as they are now, the same way the simulation does it (`scaled`, `stats.ts`). The values\n * are the ability's own (`AbilityDef.values`), or found in its effects (`damage`, `heal`, `duration`...); and an ability\n * can say all of it in code instead (`AbilityDef.describe`).\n */\n\n/**\n * What the caster brings to an ability's numbers: its stats now, its level as a hero, and the attack damage of its own\n *\n * @beta\n */\nexport interface CasterFacts {\n\t/** The stats of the caster now, which the numbers of an ability scale from */\n\tstats: Readonly<Stats>\n\t/** 1 for what is not a hero */\n\theroLevel: number\n\t/** The attack damage it has from its type and its levels, without what it carries or what is on it */\n\townAttackDamage: number\n}\n\n/**\n * What the text of an ability is worked out from: the ability at a level, its caster, and the buffs it puts on\n *\n * @beta\n */\nexport interface AbilityTextContext {\n\t/** The ability the text is worked out for */\n\tability: AbilityDef\n\t/** The level of the ability: 1 for one that has no levels */\n\tlevel: number\n\t/** What the caster brings to the ability's numbers: its stats, hero level and own attack damage */\n\tcaster: CasterFacts\n\t/** A buff by id, for how long the ones the ability puts on last */\n\tbuff?: (id: string) => BuffDef | undefined\n\t/** A value of the ability, by name, worked out (see `abilityValues`) */\n\tvalue(name: string): AbilityValue | undefined\n}\n\n/**\n * A part of a value that comes from a stat of the caster: 60% of ability power\n *\n * @beta\n */\nexport interface ValuePart {\n\t/** The stat, `level` for each level of a hero past the first, `bonusAttackDamage` for what is added to its own */\n\tstat: StatKey | 'level' | 'bonusAttackDamage'\n\t/** How much of it: 0.6 */\n\tratio: number\n\t/** What that comes to now */\n\tamount: number\n}\n\n/**\n * A number of an ability, worked out: its total, and what it is made of\n *\n * @beta\n */\nexport interface AbilityValue {\n\t/** The value in full: `base` and every part added up */\n\ttotal: number\n\t/** What it is without the stats of the caster */\n\tbase: number\n\t/** The stat-scaled parts of the value, one for each stat of the caster that adds to it */\n\tparts: ValuePart[]\n\t/** What follows the number: `s` for seconds, `%`. Nothing when left out */\n\tunit?: string\n}\n\n/**\n * How a game gives a value of an ability: an amount and what scales it, or worked out in code\n *\n * @beta\n */\nexport type AbilityValueDef =\n\t{ amount?: Scaled; scaling?: Scaling; unit?: string; percent?: boolean } | ((context: AbilityTextContext) => number | AbilityValue)\n\n/**\n * A piece of the text of an ability: words, or a value to show as one (bold, its parts in their colours)\n *\n * @beta\n */\nexport type TextSegment = string | { name: string; value: AbilityValue }\n\n/**\n * An amount with what the stats of the caster add to it, and the parts that come from each: the same arithmetic as\n * the simulation (`scaled`)\n *\n * @internal\n */\nexport function scaledParts(amount: number, scaling: Scaling | undefined, level: number, caster: CasterFacts): AbilityValue {\n\tconst parts: ValuePart[] = []\n\tlet total = amount\n\tif (scaling) {\n\t\tfor (const key in scaling) {\n\t\t\tconst stat = key as ValuePart['stat']\n\t\t\tconst ratio = at(scaling[stat], level)\n\t\t\tif (!ratio) continue\n\t\t\tconst of =\n\t\t\t\tstat === 'level'\n\t\t\t\t\t? caster.heroLevel - 1\n\t\t\t\t\t: stat === 'bonusAttackDamage'\n\t\t\t\t\t\t? Math.max(caster.stats.attackDamage - caster.ownAttackDamage, 0)\n\t\t\t\t\t\t: caster.stats[stat]\n\t\t\tconst part = of * ratio\n\t\t\ttotal += part\n\t\t\tparts.push({ stat, ratio, amount: part })\n\t\t}\n\t}\n\treturn { total, base: amount, parts }\n}\n\n/**\n * The value of an amount for an ability's text (`abilityValues`): at the level, or what its code says for the caster\n * as it is, with no effect landing and no target\n *\n * @beta\n */\nexport function valueFor(value: EffectValue | undefined, level: number, caster: CasterFacts, fallback = 0): number {\n\tif (typeof value !== 'function') return at(value, level, fallback)\n\tconst asked: EffectValueContext = { level, caster }\n\treturn value(asked)\n}\n\n/** The effects of an ability, those inside others (a missile's, a delay's) too, in order */\nfunction* allEffects(effects: readonly EffectDef[] | undefined): Iterable<EffectDef> {\n\tfor (const effect of effects ?? []) {\n\t\tyield effect\n\t\tyield* allEffects(innerEffects(effect))\n\t}\n}\n\n/**\n * The values of an ability at a level, for a caster, by name: its own (`AbilityDef.values`), and what its effects say\n * when it does not name them itself: `damage`, `heal`, `shield` and `amount` (the first effect of each kind with an\n * amount), `duration`, `radius`, `chance` (in percent), `range`, `cooldown`, `charges` and `refill`, `mana`, `window` (a recast's), `count` and `distance`\n *\n * @beta\n */\nexport function abilityValues(\n\tability: AbilityDef,\n\tlevel: number,\n\tcaster: CasterFacts,\n\tbuff?: (id: string) => BuffDef | undefined\n): Map<string, AbilityValue> {\n\tconst values = new Map<string, AbilityValue>()\n\tconst context: AbilityTextContext = { ability, level, caster, buff, value: (name) => values.get(name) }\n\tconst plain = (total: number, unit?: string): AbilityValue => ({ total, base: total, parts: [], unit })\n\tconst found = (name: string, value: AbilityValue | undefined) => {\n\t\tif (value && !values.has(name)) values.set(name, value)\n\t}\n\n\t// what the effects say, first\n\tfor (const effect of [...allEffects([...ability.effects, ...(ability.passive ?? [])])].map(anyEffect)) {\n\t\tif (effect.amount !== undefined || effect.scaling) {\n\t\t\tconst value = scaledParts(valueFor(effect.amount, level, caster), effect.scaling, level, caster)\n\t\t\tif (effect.type === 'damage' || effect.type === 'heal') found(effect.type, value)\n\t\t\tfound('amount', value)\n\t\t}\n\t\tif (effect.duration !== undefined) found('duration', plain(valueFor(effect.duration, level, caster), 's'))\n\t\telse if (effect.buff && buff) {\n\t\t\tconst lasting = buff(effect.buff)?.duration\n\t\t\tif (lasting !== undefined) found('duration', plain(at(lasting as Scaled, level), 's'))\n\t\t}\n\t\tif (effect.radius !== undefined) found('radius', plain(valueFor(effect.radius, level, caster)))\n\t\tif (effect.chance !== undefined) found('chance', plain(valueFor(effect.chance, level, caster) * 100, '%'))\n\t\tif (effect.count !== undefined) found('count', plain(at(effect.count, level)))\n\t\tif (effect.distance !== undefined) found('distance', plain(at(effect.distance, level)))\n\t}\n\tif (ability.range !== undefined) found('range', plain(at(ability.range, level)))\n\tif (ability.cooldown !== undefined) found('cooldown', plain(at(ability.cooldown, level), 's'))\n\tif (ability.charges) {\n\t\tfound('charges', plain(at(ability.charges.count, level)))\n\t\tfound('refill', plain(at(ability.charges.refill, level), 's'))\n\t}\n\tif (ability.manaCost !== undefined) found('mana', plain(at(ability.manaCost, level)))\n\tif (ability.recast) found('window', plain(at(ability.recast.window, level), 's'))\n\n\t// the ability's own, over what was found: in the order given, so one may use another\n\tfor (const [name, def] of Object.entries(ability.values ?? {})) {\n\t\tlet value: AbilityValue\n\t\tif (typeof def === 'function') {\n\t\t\tconst made = def(context)\n\t\t\tvalue = typeof made === 'number' ? plain(made) : made\n\t\t} else {\n\t\t\tvalue = scaledParts(at(def.amount, level), def.scaling, level, caster)\n\t\t\tif (def.percent) {\n\t\t\t\tvalue = {\n\t\t\t\t\ttotal: value.total * 100,\n\t\t\t\t\tbase: value.base * 100,\n\t\t\t\t\tparts: value.parts.map((part) => ({ ...part, ratio: part.ratio * 100, amount: part.amount * 100 }))\n\t\t\t\t}\n\t\t\t\tvalue.unit = '%'\n\t\t\t}\n\t\t\tif (def.unit) value.unit = def.unit\n\t\t}\n\t\tvalues.set(name, value)\n\t}\n\treturn values\n}\n\n/**\n * What the ability says it does, for this caster now: its description with each `{value}` worked out (or its own\n * `describe`), as words and values. A name it has no value for is left as it is written, braces and all\n *\n * @beta\n */\nexport function describeAbility(ability: AbilityDef, level: number, caster: CasterFacts, buff?: (id: string) => BuffDef | undefined): TextSegment[] {\n\tconst values = abilityValues(ability, level, caster, buff)\n\tconst context: AbilityTextContext = { ability, level, caster, buff, value: (name) => values.get(name) }\n\tconst said = ability.describe ? ability.describe(context) : (ability.description ?? '')\n\tif (typeof said !== 'string') return said\n\tconst segments: TextSegment[] = []\n\tlet from = 0\n\tfor (const match of said.matchAll(/\\{([a-zA-Z][\\w.]*)\\}/g)) {\n\t\tconst value = values.get(match[1])\n\t\tif (!value) continue\n\t\tif (match.index > from) segments.push(said.slice(from, match.index))\n\t\tsegments.push({ name: match[1], value })\n\t\tfrom = match.index + match[0].length\n\t}\n\tif (from < said.length) segments.push(said.slice(from))\n\treturn segments\n}\n\n/**\n * How a stat is called in the text of an ability\n *\n * @beta\n */\nexport const STAT_WORDS: Partial<Record<ValuePart['stat'], string>> = {\n\tabilityPower: 'ability power',\n\tattackDamage: 'attack damage',\n\tbonusAttackDamage: 'bonus attack damage',\n\thealth: 'max health',\n\tmana: 'max mana',\n\tarmor: 'armor',\n\tmagicResist: 'magic resist',\n\tmoveSpeed: 'move speed',\n\tattackSpeed: 'attack speed',\n\tlevel: 'per level'\n}\n\n/**\n * A number as an ability's text shows it: whole, or with one decimal when it is small and has one\n *\n * @beta\n */\nexport function formatNumber(value: number): string {\n\tconst rounded = Math.abs(value) < 10 ? Math.round(value * 10) / 10 : Math.round(value)\n\treturn String(rounded)\n}\n\n/**\n * A value in words: `80`, or `80 (50 + 60% ability power)` when stats add to it\n *\n * @beta\n */\nexport function valueText(value: AbilityValue): string {\n\tconst total = `${formatNumber(value.total)}${value.unit ?? ''}`\n\tif (value.parts.length === 0) return total\n\tconst parts = value.parts.map((part) =>\n\t\tpart.stat === 'level' ? `${formatNumber(part.ratio)} per level` : `${formatNumber(part.ratio * 100)}% ${STAT_WORDS[part.stat] ?? part.stat}`\n\t)\n\t// nothing of its own: all of it comes from the stats\n\treturn `${total} (${[...(value.base ? [formatNumber(value.base)] : []), ...parts].join(' + ')})`\n}\n\n/**\n * The text of an ability as plain words: for a tooltip of words only, a log, a test\n *\n * @beta\n */\nexport function abilityText(segments: readonly TextSegment[]): string {\n\treturn segments.map((segment) => (typeof segment === 'string' ? segment : valueText(segment.value))).join('')\n}\n"],"mappings":"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"}