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:23

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

Source identity the mount refused, or null when the mount was absent.

Remarks

ShipLoadout.fromLoadout states the rule these outcomes report: a removable mount is emptied of an article the catalogue cannot resolve, and a fixed mount is defaulted to the hull's stock article whenever the source left none it can hold — with a null sourceSymbol when the source named nothing there at all.

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'