@civ-clone/base-unit-lifecycle 0.0.0-stage → 0.1.1

package/lib/lifecycleRules.ts

@@ -0,0 +1,378 @@
+import {
+  CityRegistry,
+  instance as cityRegistryInstance,
+} from '@civ-clone/core-city/CityRegistry';
+import {
+  Engine,
+  instance as engineInstance,
+} from '@civ-clone/core-engine/Engine';
+import {
+  RuleRegistry,
+  instance as ruleRegistryInstance,
+} from '@civ-clone/core-rule/RuleRegistry';
+import {
+  TransportRegistry,
+  instance as transportRegistryInstance,
+} from '@civ-clone/core-unit-transport/TransportRegistry';
+import {
+  UnitImprovementRegistry,
+  instance as unitImprovementRegistryInstance,
+} from '@civ-clone/core-unit-improvement/UnitImprovementRegistry';
+import {
+  UnitLossRegistry,
+  instance as unitLossRegistryInstance,
+} from '@civ-clone/core-unit/UnitLossRegistry';
+import {
+  UnitPlayerActionType,
+  activeUnits,
+  hasActiveUnits,
+  hasInactiveUnits,
+  inactiveUnits,
+} from './playerAction';
+import {
+  UnitRegistry,
+  instance as unitRegistryInstance,
+} from '@civ-clone/core-unit/UnitRegistry';
+import {
+  applyVisibility,
+  emitCreated,
+  registerUnit,
+  setMoves,
+} from './created';
+import {
+  carriesCargo,
+  countLoss,
+  deactivate,
+  destroyedByAnother,
+  emitDestroyed,
+  isAboard,
+  leaveOwnTransport,
+  loseCargo,
+  notYetDestroyed,
+  removeImprovements,
+} from './destroyed';
+import { carriesDomain, carriesUnit } from './canStow';
+import {
+  clearBusy,
+  hasImprovement,
+  hasMoves,
+  isBusy,
+  removeImprovement,
+  setActive,
+} from './activate';
+import { countLosses, emitLostAtSea, sink } from './lostAtSea';
+import {
+  defended,
+  destroyStack,
+  emitAndDestroy,
+  hasStack,
+  notInCity,
+} from './defeated';
+import { fromLand, impassable, toPartnersLand } from './impassable';
+import {
+  hasMovesFor,
+  shortOfMovesFor,
+  spendMoves,
+  spendShort,
+} from './validateMove';
+import Action from '@civ-clone/core-player/Rules/Action';
+import Activate from '@civ-clone/core-unit/Rules/Activate';
+import CanStow from '@civ-clone/core-unit-transport/Rules/CanStow';
+import Created from '@civ-clone/core-unit/Rules/Created';
+import Criterion from '@civ-clone/core-rule/Criterion';
+import Defeated from '@civ-clone/core-unit/Rules/Defeated';
+import Destroyed from '@civ-clone/core-unit/Rules/Destroyed';
+import Effect from '@civ-clone/core-rule/Effect';
+import ExpectedMovementCost from '@civ-clone/core-world-path/Rules/ExpectedMovementCost';
+import Halted from '@civ-clone/base-unit-action-goto/Rules/Halted';
+import Impassable from '@civ-clone/core-world-path/Rules/Impassable';
+import LostAtSea from '@civ-clone/core-unit-transport/Rules/LostAtSea';
+import Player from '@civ-clone/core-player/Player';
+import PlayerAction from '@civ-clone/core-player/PlayerAction';
+import Stowed from '@civ-clone/core-unit-transport/Rules/Stowed';
+import Tile from '@civ-clone/core-world/Tile';
+import Transferred from '@civ-clone/core-unit/Rules/Transferred';
+import Unit from '@civ-clone/core-unit/Unit';
+import UnitImprovement from '@civ-clone/core-unit-improvement/UnitImprovement';
+import Unsupported from '@civ-clone/core-unit/Rules/Unsupported';
+import ValidateMove from '@civ-clone/core-unit/Rules/ValidateMove';
+import { emitHalted } from './halted';
+import { emitUnsupported } from './unsupported';
+import { expectedCost } from '@civ-clone/base-unit-action-rules/lib/moveShortfall';
+import { instance as rngInstance } from '@civ-clone/core-random';
+import { sleepAboard } from './stowed';
+
+export interface LifecycleDependencies {
+  cityRegistry?: CityRegistry;
+  engine?: Engine;
+  randomNumberGenerator?: () => number;
+  ruleRegistry?: RuleRegistry;
+  transportRegistry?: TransportRegistry;
+  unitImprovementRegistry?: UnitImprovementRegistry;
+  unitLossRegistry?: UnitLossRegistry;
+  unitRegistry?: UnitRegistry;
+}
+
+export interface LifecycleBaseOptions {
+  // The player actions a unit that can take orders, and one that can't, is offered as.
+  ActiveUnit: UnitPlayerActionType<PlayerAction>;
+  InactiveUnit: UnitPlayerActionType<PlayerAction>;
+  // The unit improvements activating a unit takes off it (a Fortified state), each with a rule of its own.
+  removedOnActivate: (typeof UnitImprovement)[];
+  // The domains a transport may carry, each with a `CanStow` rule of its own (`Carries` traits).
+  stowable: (typeof Unit)[];
+  // Whose land `tile` is among `unit`'s treaty partners, or `null`: routes go round it. Without it, no rule is made.
+  partnerOf?: (unit: Unit, tile: Tile) => Player | null;
+}
+
+/**
+ * How a unit short of a step's moves fares: Civ1's `shortfallFactor` (`spendShort`), or a ruleset's own `shortStep`,
+ *  which then needs no factor.
+ */
+export type LifecycleOptions = LifecycleBaseOptions &
+  (
+    | { shortfallFactor: number; shortStep?: undefined }
+    | { shortfallFactor?: number; shortStep: ShortStep }
+  );
+
+/**
+ * A ruleset's own short step: whether `unit`, with `remaining` of its `movement` moves, gets onto a square costing
+ *  `cost` (one draw of `randomNumberGenerator` at most), and what such a step is worth on average to route planning.
+ *  The unit's moves are spent either way.
+ */
+export interface ShortStep {
+  succeeds: (
+    unit: Unit,
+    remaining: number,
+    movement: number,
+    cost: number,
+    randomNumberGenerator: () => number
+  ) => boolean;
+  expectedCost: (movement: number, cost: number) => number;
+}
+
+/**
+ * A ruleset's unit lifecycle rules, by the rule type they are, in the order each type's rules run. Their ids are
+ * `<prefix>:unit/<type>/<name>` (`<prefix>:player/action/<name>` for the player actions), as civ1-unit's are, so a
+ * ruleset registers each list where it wants it and keeps the ids another package may name.
+ */
+export const lifecycleRules = (
+  prefix: string,
+  {
+    cityRegistry = cityRegistryInstance,
+    engine = engineInstance,
+    randomNumberGenerator = rngInstance,
+    ruleRegistry = ruleRegistryInstance,
+    transportRegistry = transportRegistryInstance,
+    unitImprovementRegistry = unitImprovementRegistryInstance,
+    unitLossRegistry = unitLossRegistryInstance,
+    unitRegistry = unitRegistryInstance,
+  }: LifecycleDependencies,
+  {
+    ActiveUnit,
+    InactiveUnit,
+    removedOnActivate,
+    stowable,
+    partnerOf,
+    shortfallFactor,
+    shortStep,
+  }: LifecycleOptions
+) => {
+  const id = (name: string): string => `${prefix}:unit/${name}`;
+
+  return {
+    activate: [
+      new Activate(
+        id('activate/has-moves'),
+        new Criterion(hasMoves),
+        new Effect(setActive)
+      ),
+      new Activate(
+        id('activate/clear-busy'),
+        new Criterion(isBusy),
+        new Effect(clearBusy)
+      ),
+      ...removedOnActivate.map(
+        (UnitImprovementType: typeof UnitImprovement): Activate =>
+          new Activate(
+            id(`activate/remove-improvement/${UnitImprovementType.name}`),
+            new Criterion(
+              hasImprovement(unitImprovementRegistry, UnitImprovementType)
+            ),
+            new Effect(
+              removeImprovement(unitImprovementRegistry, UnitImprovementType)
+            )
+          )
+      ),
+    ],
+
+    canStow: stowable.map(
+      (StowableUnitType: typeof Unit): CanStow =>
+        new CanStow(
+          id(`can-stow/${StowableUnitType.name}`),
+          new Criterion(carriesDomain(StowableUnitType)),
+          new Effect(carriesUnit(StowableUnitType))
+        )
+    ),
+
+    created: [
+      new Created(
+        id('created/register'),
+        new Effect(registerUnit(unitRegistry))
+      ),
+      new Created(id('created/apply-visibility'), new Effect(applyVisibility)),
+      new Created(id('created/set-moves'), new Effect(setMoves)),
+      new Created(id('created/emit'), new Effect(emitCreated(engine))),
+    ],
+
+    defeated: [
+      new Defeated(
+        id('defeated/emit-and-destroy'),
+        new Effect(emitAndDestroy(engine, ruleRegistry))
+      ),
+      new Defeated(
+        // `Attack` processes `Defeated` for a losing attacker too; only a defeated defender takes its stack with it.
+        id('defeated/destroy-stack'),
+        new Criterion(defended),
+        new Criterion(notInCity(cityRegistry)),
+        new Criterion(hasStack(unitRegistry)),
+        new Effect(destroyStack(unitRegistry, ruleRegistry))
+      ),
+    ],
+
+    destroyed: [
+      new Destroyed(id('destroyed/emit'), new Effect(emitDestroyed(engine))),
+      new Destroyed(
+        // A loss, once, for a unit another player destroyed.
+        id('destroyed/count-loss'),
+        new Criterion(destroyedByAnother),
+        new Criterion(notYetDestroyed),
+        new Effect(countLoss(unitLossRegistry))
+      ),
+      new Destroyed(id('destroyed/deactivate'), new Effect(deactivate)),
+      new Destroyed(
+        id('destroyed/remove-improvements'),
+        new Effect(removeImprovements(unitImprovementRegistry))
+      ),
+      new Destroyed(
+        id('destroyed/lose-cargo'),
+        new Criterion(carriesCargo(transportRegistry)),
+        new Effect(loseCargo(transportRegistry))
+      ),
+      new Destroyed(
+        id('destroyed/leave-transport'),
+        new Criterion(isAboard(transportRegistry)),
+        new Effect(leaveOwnTransport(transportRegistry))
+      ),
+    ],
+
+    expectedMovementCost: [
+      new ExpectedMovementCost(
+        // A step costing more than the unit's full moves is worth `max(m, c × shortfallFactor)` on average.
+        id('expected-movement-cost/shortfall'),
+        new Criterion(
+          (unit: Unit, movementCost: number, movement: number): boolean =>
+            movement > 0
+        ),
+        new Effect(
+          (unit: Unit, movementCost: number, movement: number): number =>
+            shortStep === undefined
+              ? expectedCost(movement, movementCost, shortfallFactor as number)
+              : shortStep.expectedCost(movement, movementCost)
+        )
+      ),
+    ],
+
+    halted: [new Halted(id('halted/emit'), new Effect(emitHalted(engine)))],
+
+    impassable:
+      partnerOf === undefined
+        ? []
+        : [
+            new Impassable(
+              // Routes go round a treaty partner's land, so following one never breaks a treaty by accident.
+              id('impassable/treaty-partners-land'),
+              new Criterion(fromLand),
+              new Criterion(toPartnersLand(partnerOf)),
+              new Effect(impassable)
+            ),
+          ],
+
+    lostAtSea: [
+      new LostAtSea(id('lost-at-sea/emit'), new Effect(emitLostAtSea(engine))),
+      new LostAtSea(
+        // Before `destroy`, while the manifests still say what's aboard.
+        id('lost-at-sea/count-loss'),
+        new Effect(countLosses(unitLossRegistry, transportRegistry))
+      ),
+      new LostAtSea(id('lost-at-sea/destroy'), new Effect(sink)),
+    ],
+
+    playerAction: [
+      new Action(
+        `${prefix}:player/action/active-units`,
+        new Criterion(hasActiveUnits(unitRegistry)),
+        new Effect(activeUnits(unitRegistry, ActiveUnit))
+      ),
+      new Action(
+        `${prefix}:player/action/inactive-units`,
+        new Criterion(hasInactiveUnits(unitRegistry)),
+        new Effect(inactiveUnits(unitRegistry, InactiveUnit))
+      ),
+    ],
+
+    stowed: [new Stowed(id('stowed/sleep'), new Effect(sleepAboard))],
+
+    transferred: [
+      new Transferred(
+        id('transferred/emit'),
+        new Effect(
+          (unit: Unit, player: Player, previousPlayer: Player): void => {
+            engine.emit('unit:transferred', unit, player, previousPlayer);
+          }
+        )
+      ),
+    ],
+
+    unsupported: [
+      new Unsupported(
+        id('unsupported/emit'),
+        new Effect(emitUnsupported(engine))
+      ),
+    ],
+
+    validateMove: [
+      new ValidateMove(
+        id('validate-move/enough-moves'),
+        new Criterion(hasMovesFor),
+        new Effect(spendMoves)
+      ),
+      new ValidateMove(
+        id('validate-move/not-enough-moves'),
+        new Criterion(shortOfMovesFor),
+        new Effect(
+          shortStep === undefined
+            ? spendShort(shortfallFactor as number, randomNumberGenerator)
+            : (unit: Unit, movementCost: number): boolean => {
+                const remaining = unit.moves().value(),
+                  movement = unit.movement().value();
+
+                unit.moves().set(0);
+
+                return shortStep.succeeds(
+                  unit,
+                  remaining,
+                  movement,
+                  movementCost,
+                  randomNumberGenerator
+                );
+              }
+        )
+      ),
+    ],
+  };
+};
+
+export type LifecycleRules = ReturnType<typeof lifecycleRules>;
+
+export default lifecycleRules;

package/lib/lostAtSea.d.ts

@@ -0,0 +1,12 @@
+import Engine from '@civ-clone/core-engine/Engine';
+import { ITransport } from '@civ-clone/core-unit-transport/Transport';
+import TransportRegistry from '@civ-clone/core-unit-transport/TransportRegistry';
+import UnitLossRegistry from '@civ-clone/core-unit/UnitLossRegistry';
+export declare const emitLostAtSea: (
+  engine: Engine
+) => (unit: ITransport) => void;
+export declare const countLosses: (
+  unitLossRegistry: UnitLossRegistry,
+  transportRegistry: TransportRegistry
+) => (transport: ITransport) => void;
+export declare const sink: (unit: ITransport) => void;

package/lib/lostAtSea.js

@@ -0,0 +1,26 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.sink = exports.countLosses = exports.emitLostAtSea = void 0;
+// What a ruleset's `LostAtSea` rules do when a transport is lost at sea.
+// Emits `unit:lost-at-sea` with the transport.
+const emitLostAtSea = (engine) => (unit) => {
+    engine.emit('unit:lost-at-sea', unit);
+};
+exports.emitLostAtSea = emitLostAtSea;
+// Records the transport and everything aboard that isn't destroyed yet as losses of their players, though no one
+//  destroyed them. Run it before `sink`, while the manifests still say what's aboard.
+const countLosses = (unitLossRegistry, transportRegistry) => (transport) => [
+    transport,
+    ...transportRegistry
+        .getByTransport(transport)
+        .map((manifest) => manifest.unit()),
+]
+    .filter((unit) => !unit.destroyed())
+    .forEach((unit) => {
+    unitLossRegistry.record(unit.player(), unit.sourceClass());
+});
+exports.countLosses = countLosses;
+// Destroys the transport, by no one.
+const sink = (unit) => unit.destroy(null);
+exports.sink = sink;
+//# sourceMappingURL=lostAtSea.js.map

package/lib/lostAtSea.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lostAtSea.js","sourceRoot":"","sources":["lostAtSea.ts"],"names":[],"mappings":";;;AAOA,yEAAyE;AAEzE,+CAA+C;AACxC,MAAM,aAAa,GACxB,CAAC,MAAc,EAAE,EAAE,CACnB,CAAC,IAAgB,EAAQ,EAAE;IACzB,MAAM,CAAC,IAAI,CAAC,kBAAkB,EAAE,IAAI,CAAC,CAAC;AACxC,CAAC,CAAC;AAJS,QAAA,aAAa,iBAItB;AAEJ,iHAAiH;AACjH,sFAAsF;AAC/E,MAAM,WAAW,GACtB,CAAC,gBAAkC,EAAE,iBAAoC,EAAE,EAAE,CAC7E,CAAC,SAAqB,EAAQ,EAAE,CAC9B;IACE,SAA4B;IAC5B,GAAG,iBAAiB;SACjB,cAAc,CAAC,SAAS,CAAC;SACzB,GAAG,CAAC,CAAC,QAA2B,EAAQ,EAAE,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;CAC/D;KACE,MAAM,CAAC,CAAC,IAAU,EAAW,EAAE,CAAC,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;KAClD,OAAO,CAAC,CAAC,IAAU,EAAQ,EAAE;IAC5B,gBAAgB,CAAC,MAAM,CACrB,IAAI,CAAC,MAAM,EAAE,EACb,IAAI,CAAC,WAAW,EAAiB,CAClC,CAAC;AACJ,CAAC,CAAC,CAAC;AAfI,QAAA,WAAW,eAef;AAET,qCAAqC;AAC9B,MAAM,IAAI,GAAG,CAAC,IAAgB,EAAQ,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;AAAtD,QAAA,IAAI,QAAkD"}

package/lib/lostAtSea.ts

@@ -0,0 +1,37 @@
+import Engine from '@civ-clone/core-engine/Engine';
+import { ITransport } from '@civ-clone/core-unit-transport/Transport';
+import TransportManifest from '@civ-clone/core-unit-transport/TransportManifest';
+import TransportRegistry from '@civ-clone/core-unit-transport/TransportRegistry';
+import Unit from '@civ-clone/core-unit/Unit';
+import UnitLossRegistry from '@civ-clone/core-unit/UnitLossRegistry';
+
+// What a ruleset's `LostAtSea` rules do when a transport is lost at sea.
+
+// Emits `unit:lost-at-sea` with the transport.
+export const emitLostAtSea =
+  (engine: Engine) =>
+  (unit: ITransport): void => {
+    engine.emit('unit:lost-at-sea', unit);
+  };
+
+// Records the transport and everything aboard that isn't destroyed yet as losses of their players, though no one
+//  destroyed them. Run it before `sink`, while the manifests still say what's aboard.
+export const countLosses =
+  (unitLossRegistry: UnitLossRegistry, transportRegistry: TransportRegistry) =>
+  (transport: ITransport): void =>
+    [
+      transport as unknown as Unit,
+      ...transportRegistry
+        .getByTransport(transport)
+        .map((manifest: TransportManifest): Unit => manifest.unit()),
+    ]
+      .filter((unit: Unit): boolean => !unit.destroyed())
+      .forEach((unit: Unit): void => {
+        unitLossRegistry.record(
+          unit.player(),
+          unit.sourceClass() as typeof Unit
+        );
+      });
+
+// Destroys the transport, by no one.
+export const sink = (unit: ITransport): void => unit.destroy(null);

package/lib/movedRules.d.ts

@@ -0,0 +1,44 @@
+import { CityRegistry } from '@civ-clone/core-city/CityRegistry';
+import { Engine } from '@civ-clone/core-engine/Engine';
+import { InteractionRegistry } from '@civ-clone/core-diplomacy/InteractionRegistry';
+import { RuleRegistry } from '@civ-clone/core-rule/RuleRegistry';
+import { TransportRegistry } from '@civ-clone/core-unit-transport/TransportRegistry';
+import { UnitRegistry } from '@civ-clone/core-unit/UnitRegistry';
+import Action from '@civ-clone/core-unit/Action';
+import Moved from '@civ-clone/core-unit/Rules/Moved';
+type ActionType = abstract new (...args: any[]) => Action;
+export interface MovedDependencies {
+  cityRegistry?: CityRegistry;
+  engine?: Engine;
+  interactionRegistry?: InteractionRegistry;
+  randomNumberGenerator?: () => number;
+  ruleRegistry?: RuleRegistry;
+  transportRegistry?: TransportRegistry;
+  unitRegistry?: UnitRegistry;
+}
+export interface MovedOptions {
+  Move: ActionType;
+  Disembark: ActionType;
+  attacks: ActionType[];
+  noVendetta: ActionType[];
+  coastBoundLoss: number;
+}
+/**
+ * A ruleset's `Moved` rules, in order, with ids `<prefix>:unit/moved/<name>` as civ1-unit's are: telling the client,
+ * vision, ending a unit's moves, transports carrying and collecting their cargo, leaving a transport, a `CoastBound`
+ * unit lost at sea, an `AttackEndsTurn` unit's turn ending, and a broken peace treaty.
+ */
+export declare const movedRules: (
+  prefix: string,
+  {
+    cityRegistry,
+    engine,
+    interactionRegistry,
+    randomNumberGenerator,
+    ruleRegistry,
+    transportRegistry,
+    unitRegistry,
+  }: MovedDependencies,
+  { Move, Disembark, attacks, noVendetta, coastBoundLoss }: MovedOptions
+) => Moved[];
+export default movedRules;

package/lib/movedRules.js

@@ -0,0 +1,126 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.movedRules = void 0;
+const CityRegistry_1 = require("@civ-clone/core-city/CityRegistry");
+const Engine_1 = require("@civ-clone/core-engine/Engine");
+const InteractionRegistry_1 = require("@civ-clone/core-diplomacy/InteractionRegistry");
+const RuleRegistry_1 = require("@civ-clone/core-rule/RuleRegistry");
+const TransportRegistry_1 = require("@civ-clone/core-unit-transport/TransportRegistry");
+const UnitRegistry_1 = require("@civ-clone/core-unit/UnitRegistry");
+const Declarations_1 = require("@civ-clone/library-diplomacy/Declarations");
+const Air_1 = require("@civ-clone/base-unit-type-air/Air");
+const AttackEndsTurn_1 = require("@civ-clone/base-unit-trait-attack-ends-turn/AttackEndsTurn");
+const CoastBound_1 = require("@civ-clone/base-unit-trait-coast-bound/CoastBound");
+const Criterion_1 = require("@civ-clone/core-rule/Criterion");
+const Effect_1 = require("@civ-clone/core-rule/Effect");
+const High_1 = require("@civ-clone/core-rule/Priorities/High");
+const LostAtSea_1 = require("@civ-clone/core-unit-transport/Rules/LostAtSea");
+const Moved_1 = require("@civ-clone/core-unit/Rules/Moved");
+const NavalTransport_1 = require("@civ-clone/base-unit-type-naval-transport/NavalTransport");
+const Never_1 = require("@civ-clone/core-diplomacy/Expiries/Never");
+const Sleeping_1 = require("@civ-clone/base-unit-action-sleep/Rules/Sleeping");
+const Stowed_1 = require("@civ-clone/base-unit-action-embark/Busy/Stowed");
+const holds_1 = require("@civ-clone/library-diplomacy/lib/holds");
+const core_random_1 = require("@civ-clone/core-random");
+/**
+ * A ruleset's `Moved` rules, in order, with ids `<prefix>:unit/moved/<name>` as civ1-unit's are: telling the client,
+ * vision, ending a unit's moves, transports carrying and collecting their cargo, leaving a transport, a `CoastBound`
+ * unit lost at sea, an `AttackEndsTurn` unit's turn ending, and a broken peace treaty.
+ */
+const movedRules = (prefix, { cityRegistry = CityRegistry_1.instance, engine = Engine_1.instance, interactionRegistry = InteractionRegistry_1.instance, randomNumberGenerator = core_random_1.instance, ruleRegistry = RuleRegistry_1.instance, transportRegistry = TransportRegistry_1.instance, unitRegistry = UnitRegistry_1.instance, }, { Move, Disembark, attacks, noVendetta, coastBoundLoss }) => {
+    const id = (name) => `${prefix}:unit/moved/${name}`, 
+    // Stows each of `units` aboard `transport`, as `Embark` and `LandAircraft` do, until it is full.
+    collect = (transport, units) => units.forEach((unit) => {
+        if (!transport.hasCapacity() || !transport.canStow(unit)) {
+            return;
+        }
+        transport.stow(unit, unit.tile());
+        unit.setBusy(new Stowed_1.default());
+    }), 
+    // The transport's own units on the tile it has just moved onto, that aren't already aboard something.
+    unitsToCollect = (transport, tile = transport.tile()) => unitRegistry
+        .getByTile(tile)
+        .filter((unit) => unit !== transport &&
+        unit.player() === transport.player() &&
+        !transportRegistry.hasUnit(unit)), 
+    // A transport's own move that took it onto a new tile (not one it was carried along on, and not an attack).
+    transportMoved = [
+        new Criterion_1.default((unit) => unit instanceof NavalTransport_1.default),
+        new Criterion_1.default((unit, action) => action instanceof Move),
+        new Criterion_1.default((unit, action) => action.to() === unit.tile()),
+    ], isOwnCity = (unit) => { var _a; return ((_a = cityRegistry.getByTile(unit.tile())) === null || _a === void 0 ? void 0 : _a.player()) === unit.player(); };
+    return [
+        new Moved_1.default(id('emit'), new Effect_1.default((unit, action) => {
+            engine.emit('unit:moved', unit, action);
+        })),
+        new Moved_1.default(id('apply-visibility'), new Effect_1.default((unit) => unit.applyVisibility())),
+        new Moved_1.default(id('end-moves-when-exhausted'), new Criterion_1.default((unit) => unit.moves().value() < 0.3), new Effect_1.default((unit) => {
+            unit.moves().set(0);
+            unit.setActive(false);
+        })),
+        new Moved_1.default(
+        // A transport leaving one of its player's cities takes only the units sentried aboard (`Stowed` or `Sleeping`);
+        //  at sea, all of its cargo goes with it, and so does an aircraft aboard, awake or not.
+        id('move-cargo'), new Criterion_1.default((unit) => unit instanceof NavalTransport_1.default), new Criterion_1.default((unit, action) => action instanceof Move), new Criterion_1.default((unit) => unit.hasCargo()), new Effect_1.default((unit, action) => {
+            var _a;
+            const transport = unit, leftPort = ((_a = cityRegistry.getByTile(action.from())) === null || _a === void 0 ? void 0 : _a.player()) === unit.player();
+            transport.cargo().forEach((cargo) => {
+                if (leftPort &&
+                    !(cargo instanceof Air_1.default) &&
+                    !(cargo.busy() instanceof Stowed_1.default) &&
+                    !(cargo.busy() instanceof Sleeping_1.default)) {
+                    transport.unload(cargo);
+                    return;
+                }
+                cargo.action(action.forUnit(cargo));
+            });
+        })),
+        // These two come after `move-cargo`, so a unit collected here isn't also sent along the move just made.
+        new Moved_1.default(
+        // A carrier that moves onto its player's aircraft outside a city picks them up.
+        id('collect-aircraft'), ...transportMoved, new Criterion_1.default((unit) => !isOwnCity(unit)), new Effect_1.default((unit) => collect(unit, unitsToCollect(unit).filter((tileUnit) => tileUnit instanceof Air_1.default)))),
+        new Moved_1.default(
+        // A transport that moves into one of its player's cities picks up the units sleeping there.
+        id('collect-sleeping'), ...transportMoved, new Criterion_1.default((unit) => isOwnCity(unit)), new Effect_1.default((unit) => collect(unit, unitsToCollect(unit).filter((tileUnit) => tileUnit.busy() instanceof Sleeping_1.default)))),
+        new Moved_1.default(id('disembark'), new Criterion_1.default((unit, action) => action instanceof Disembark), new Effect_1.default((unit) => {
+            const manifest = transportRegistry.getByUnit(unit);
+            manifest.transport().unload(unit);
+            transportRegistry.unregister(manifest);
+        })),
+        new Moved_1.default(
+        // A unit that leaves its transport's tile with a plain move (an aircraft taking off, a unit walking off a ship in
+        //  a city) is no longer aboard. A `Disembark` is a move too, which `disembark` unloads.
+        id('take-off'), new Criterion_1.default((unit, action) => action instanceof Move), new Criterion_1.default((unit, action) => !(action instanceof Disembark)), new Criterion_1.default((unit) => transportRegistry.hasUnit(unit)), new Criterion_1.default((unit) => transportRegistry.getByUnit(unit).transport().tile() !== unit.tile()), new Effect_1.default((unit) => {
+            transportRegistry.getByUnit(unit).transport().unload(unit);
+            if (unit.busy() instanceof Stowed_1.default) {
+                unit.setBusy();
+            }
+        })),
+        new Moved_1.default(id('trireme-lost-at-sea'), new Criterion_1.default((unit) => unit.hasTrait(CoastBound_1.default)), new Criterion_1.default((unit) => unit.moves().value() === 0), new Criterion_1.default((unit) => !unit.tile().isCoast()), new Criterion_1.default(() => randomNumberGenerator() <= coastBoundLoss), new Effect_1.default((unit) => {
+            ruleRegistry.process(LostAtSea_1.default, unit);
+        })),
+        new Moved_1.default(
+        // A unit that `AttackEndsTurn` can't attack again until next turn.
+        id('bomber/end-turn-after-attack'), new High_1.default(), new Criterion_1.default((unit) => unit.hasTrait(AttackEndsTurn_1.default)), new Criterion_1.default((unit, action) => attacks.some((AttackType) => action instanceof AttackType)), new Effect_1.default((unit) => {
+            unit.moves().set(0);
+            unit.setActive(false);
+        })),
+        new Moved_1.default(id('break-peace-treaty'), 
+        // Any action with an enemy: a sneak attack or capture, or a covert action at peace.
+        new Criterion_1.default((unit, action) => typeof action.enemy === 'function'), new Effect_1.default((unit, action) => {
+            const enemy = action.enemy(), peaceTreaties = interactionRegistry
+                .getByPlayers(unit.player(), enemy)
+                .filter((interaction) => interaction instanceof Declarations_1.Peace && interaction.active());
+            peaceTreaties.forEach((peaceTreaty) => peaceTreaty.expire(unit.player()));
+            // The victim of an attack in peacetime holds a grudge; walking onto or pillaging its land only ends the treaty.
+            if (peaceTreaties.length > 0 &&
+                !noVendetta.some((ActionType) => action instanceof ActionType) &&
+                !(0, holds_1.hasVendetta)(enemy, unit.player(), interactionRegistry)) {
+                interactionRegistry.register(new Declarations_1.Vendetta(enemy, unit.player(), new Never_1.default(), ruleRegistry));
+            }
+        })),
+    ];
+};
+exports.movedRules = movedRules;
+exports.default = exports.movedRules;
+//# sourceMappingURL=movedRules.js.map

package/lib/movedRules.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"movedRules.js","sourceRoot":"","sources":["movedRules.ts"],"names":[],"mappings":"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"}