@v12-engine/engine 0.1.1 → 0.4.0

package/dist/systems/life.js

@@ -0,0 +1,32 @@
+import { detection } from "../entity.js";
+//#region src/systems/life.ts
+/** Counts down what only lasts a while: things that are gone after some time, invisibility setting in, being found, spots that are revealed */
+var lifeSystem = {
+	name: "life",
+	phase: "cleanup",
+	update(world) {
+		const { dt } = world;
+		for (const entity of world.units.values()) {
+			if (!entity.alive) continue;
+			if (entity.unseenIn) entity.unseenIn = Math.max(entity.unseenIn - dt, 0);
+			const detected = entity.get(detection);
+			if (detected) {
+				for (const [team, left] of detected) if (left > dt) detected.set(team, left - dt);
+				else detected.delete(team);
+				if (detected.size === 0) entity.remove(detection);
+			}
+			if (entity.expires !== null) {
+				if (entity.expireIn(entity.expires - dt) <= 0) world.kill(entity, void 0, false, "expired");
+			}
+		}
+		for (let i = world.reveals.length - 1; i >= 0; i--) {
+			const reveal = world.reveals[i];
+			reveal.left -= dt;
+			if (reveal.left <= 0) world.reveals.splice(i, 1);
+		}
+	}
+};
+//#endregion
+export { lifeSystem };
+
+//# sourceMappingURL=life.js.map

package/dist/systems/life.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"life.js","names":[],"sources":["../../src/systems/life.ts"],"sourcesContent":["import { detection } from '#engine/entity'\nimport type { System } from '#engine/registry'\nimport type { World } from '#engine/world'\n\n/** Counts down what only lasts a while: things that are gone after some time, invisibility setting in, being found, spots that are revealed */\nexport const lifeSystem: System = {\n\tname: 'life',\n\tphase: 'cleanup',\n\tupdate(world: World) {\n\t\tconst { dt } = world\n\t\tfor (const entity of world.units.values()) {\n\t\t\tif (!entity.alive) continue\n\t\t\tif (entity.unseenIn) entity.unseenIn = Math.max(entity.unseenIn - dt, 0)\n\t\t\tconst detected = entity.get(detection)\n\t\t\tif (detected) {\n\t\t\t\tfor (const [team, left] of detected) {\n\t\t\t\t\tif (left > dt) detected.set(team, left - dt)\n\t\t\t\t\telse detected.delete(team)\n\t\t\t\t}\n\t\t\t\tif (detected.size === 0) entity.remove(detection)\n\t\t\t}\n\t\t\tif (entity.expires !== null) {\n\t\t\t\tconst left = entity.expireIn(entity.expires - dt)!\n\t\t\t\tif (left <= 0) world.kill(entity, undefined, false, 'expired')\n\t\t\t}\n\t\t}\n\t\tfor (let i = world.reveals.length - 1; i >= 0; i--) {\n\t\t\tconst reveal = world.reveals[i]\n\t\t\treveal.left -= dt\n\t\t\tif (reveal.left <= 0) world.reveals.splice(i, 1)\n\t\t}\n\t}\n}\n"],"mappings":";;;AAKA,IAAa,aAAqB;CACjC,MAAM;CACN,OAAO;CACP,OAAO,OAAc;EACpB,MAAM,EAAE,OAAO;EACf,KAAK,MAAM,UAAU,MAAM,MAAM,OAAO,GAAG;GAC1C,IAAI,CAAC,OAAO,OAAO;GACnB,IAAI,OAAO,UAAU,OAAO,WAAW,KAAK,IAAI,OAAO,WAAW,IAAI,CAAC;GACvE,MAAM,WAAW,OAAO,IAAI,SAAS;GACrC,IAAI,UAAU;IACb,KAAK,MAAM,CAAC,MAAM,SAAS,UAC1B,IAAI,OAAO,IAAI,SAAS,IAAI,MAAM,OAAO,EAAE;SACtC,SAAS,OAAO,IAAI;IAE1B,IAAI,SAAS,SAAS,GAAG,OAAO,OAAO,SAAS;GACjD;GACA,IAAI,OAAO,YAAY,MACT;QAAA,OAAO,SAAS,OAAO,UAAU,EAC1C,KAAQ,GAAG,MAAM,KAAK,QAAQ,KAAA,GAAW,OAAO,SAAS;GAAA;EAE/D;EACA,KAAK,IAAI,IAAI,MAAM,QAAQ,SAAS,GAAG,KAAK,GAAG,KAAK;GACnD,MAAM,SAAS,MAAM,QAAQ;GAC7B,OAAO,QAAQ;GACf,IAAI,OAAO,QAAQ,GAAG,MAAM,QAAQ,OAAO,GAAG,CAAC;EAChD;CACD;AACD"}

package/dist/systems/movement.d.ts

@@ -3,16 +3,26 @@ import { type Vec2 } from '#engine/math';
 import type { AgentState } from '#engine/navigation/navigation';
 import type { System } from '#engine/registry';
 import type { World } from '#engine/world';
-/** @beta */
+/**
+ * Options for a move order given by code: arrival range, group, facing to end on and whether it is a step aside
+ *
+ * @beta
+ */
 export interface MoveOptions {
     /** Arrive once this close to the goal. `ARRIVE_RANGE` when left out */
     range?: number;
+    /**
+     * The id of the group ordered to move together (0 for none): a unit bumping into a group mate that already arrived
+     * on the point it goes to stops rather than push it, and those of a formation (`MovementState.formation`) keep
+     * their places
+     */
     groupId?: number;
     /** Direction to turn to after arriving */
     facing?: number;
     /**
-     * A step aside for another (`stepAside`), or any short move that is nobody's business: the unit goes round nobody
-     * and asks nobody to make way on it, so that one step does not set off the next
+     * A step aside for another (`stepAside`), or any short move that is nobody's business: the unit goes round nobody,
+     * and asks those in its way aside only once held up, and only a few deep (`MovementState.asideDepth`), so that one
+     * step does not set off the next through a whole crowd
      */
     aside?: boolean;
 }
@@ -25,8 +35,9 @@ export declare function approachPoint(world: World, entity: Entity, target: Enti
 export declare function walkOn(world: World, entity: Entity): void;
 /**
  * Sends a unit walking to a point, the way around what is in the way. How it goes is in `entity.movement.status`:
- * `moving` on the way, `arrived` once there, `failed` when there is no way there or it got stuck. An order calls
- * this once and then watches the status; calling it again with the same goal starts the walk over
+ * `moving` on the way, `arrived` once there, `failed` when there is no way there or it got stuck. Held up by others
+ * it tries again a few times before it gives up (`MovementState.tries`). An order calls this once and then watches the
+ * status; calling it again with the same goal starts the walk over
  *
  * @beta
  */
@@ -56,15 +67,16 @@ export declare function setAnchored(world: World, entity: Entity, anchored: bool
  */
 export declare function setGhost(world: World, entity: Entity, ghost: boolean): void;
 /**
- * Turns a unit a little towards a point, as far as it turns in `dt` seconds. For orders that aim at something
+ * Turns a unit a little towards a point, as far as it turns in `dt` seconds (its type's `turnRate`, else the game's:
+ * `RuleSettings.movement.turnRate`). For orders that aim at something
  *
  * @beta
  */
-export declare function faceTowards(entity: Entity, point: Vec2, dt: number): void;
+export declare function faceTowards(world: World, entity: Entity, point: Vec2, dt: number): void;
 /**
  * Whether another unit stands in a mover's way: there, standing still, and on the same crowd, where each steers
  * round the other and neither walks through. What moves is steered round by the navigation; what is a ghost is walked
- * through; what flies, sails or is of another size goes its own way. What the mover walks to, or stands where it is
+ * through; what flies or sails goes its own way. What the mover walks to, or stands where it is
  * going, is not in its way either: it stops by it, close enough (a follower by the one it follows, a unit sent where
  * another stands), rather than send it off
  *
@@ -72,7 +84,7 @@ export declare function faceTowards(entity: Entity, point: Vec2, dt: number): vo
  */
 export declare function standsInWay(world: World, mover: Entity, other: Entity): boolean;
 /**
- * Asks an ally standing in a unit's way to step aside, as the rules allow (`GameRules.movement.makesWay`, the `makeWay` hook).
+ * Asks an ally standing in a unit's way to step aside, as the rules allow (`RuleSettings.movement.makesWay`, the `makeWay` hook).
  * `direction` is the way the unit is heading, a unit long; `agent` where its path goes, for the step to be off it.
  * True when it goes
  *
@@ -87,9 +99,9 @@ export declare function stepAside(world: World, mover: Entity, other: Entity, di
  */
 export declare function makeWay(world: World, entity: Entity): void;
 /**
- * Looks ahead of a unit on its way for units standing in it (within `GameRules.movement.lookAhead`): a way round the knot
- * they make is taken where it is not much longer (`GameRules.movement.goesAround`, the `detour` hook); otherwise those of
- * them that make way (`GameRules.movement.makesWay`) are asked to step aside before the unit reaches them. The way round is
+ * Looks ahead of a unit on its way for units standing in it (within `RuleSettings.movement.lookAhead`): a way round the knot
+ * they make is taken where it is not much longer (`RuleSettings.movement.goesAround`, the `detour` hook); otherwise those of
+ * them that make way (`RuleSettings.movement.makesWay`) are asked to step aside before the unit reaches them. The way round is
  * beside the knot, on the side it sticks out less, at the knot's middle; the unit heads there, and on to its path
  * from there. The number of units sent to this per tick is spread by their ids (`LOOK_AHEAD_INTERVAL`)
  *