ships.TypeAlias.LoadoutImportOutcome

@elite-dangerous-almanac/core / ships / LoadoutImportOutcome

Type Alias: LoadoutImportOutcome

LoadoutImportOutcome = { action: "emptied"; slot: string; sourceSymbol: string; } | { action: "defaulted"; replacementSymbol: string; slot: string; sourceSymbol: string | null; }

Defined in: src/ships/loadout-import-outcome.ts:28

A change made while normalizing a journal or SLEF loadout against the catalogues.

Union Members

Type Literal

{ action: "emptied"; slot: string; sourceSymbol: string; }

action

readonly action: "emptied"

The unresolved module was removed because no stock replacement applies.

slot

readonly slot: string

Exact slot spelling used by the imported build.

sourceSymbol

readonly sourceSymbol: string

Unresolved module identity supplied by the source.

---

Type Literal

{ action: "defaulted"; replacementSymbol: string; slot: string; sourceSymbol: string | null; }

action

readonly action: "defaulted"

The hull's stock module was installed in a fixed mount.

replacementSymbol

readonly replacementSymbol: string

Stock module identity installed in the mount.

slot

readonly slot: string

Exact slot spelling used by the normalized build.

sourceSymbol

readonly sourceSymbol: string | null

Unresolved source identity, or null when the mount was absent.

Remarks

Import removes an unresolved module from a hardpoint, utility, optional internal or unrecognised slot, and replaces one in a fixed mount — armour, the seven core internals, the cargo hatch — with the hull's stock module. ShipLoadout.fromLoadout states the rule in full, including what survives unresolved and produces no outcome.

sourceSymbol is null only for a cargo hatch restored to a source that named none, the one mount import fills unasked. A replacement keeps the source's On, Priority and Health, which describe the mount rather than the article, and none of its engineering or captured value.

Example

import { ShipLoadout } from '@elite-dangerous-almanac/core/ships/ship-loadout';

const build = ShipLoadout.fromLoadout({
  Ship: 'SideWinder',
  Modules: [{ Slot: 'SmallHardpoint1', Item: 'FutureWeapon' }],
});

build.importOutcomes.find((outcome) => outcome.slot === 'SmallHardpoint1')?.action;
// -> 'emptied'