@aephia/atlas-kit 0.6.0-next.99 → 0.6.0

package/dist/fleets/actions/sync.js

@@ -0,0 +1,55 @@
+import { SageSdkError } from '../../client/errors.js';
+import { readContextRawAccounts } from '../../client/reconciliation.js';
+import { requireGameAddress } from '../../internal/game-context.js';
+import { deriveFleetAddress, fleetAccountDefinition, } from '../../internal/c4/fleet.js';
+import { syncFleetWithGameInstruction } from '../../internal/c4/fleet-sync.js';
+import { buildPlannerPlan } from '../../planning/plan-construction.js';
+import { readFreshGameShipDefinitionSequence } from '../../registry/ships.js';
+/** Plans the permissionless Fleet sync with the configured Game. Verified
+ * against the program's behaviour: it rebuilds the Fleet's ship counts and
+ * stats from the current ship definitions and caps its AP, SP, HP and pending
+ * repair at the new maxima, in any Fleet state. Run it, confirm it, then
+ * replan an action that refuses a Fleet built under older ship definitions,
+ * such as ship assembly, crew transfer or signal detection.
+ * `deriveFleetCompositionStats` projects the rebuilt stats beforehand.
+ *
+ * Only the Game and the Fleet are involved: no Profile key signs it and no
+ * storage is funded, so any fee payer can submit it for any Fleet. A Fleet
+ * already on the current definitions only has its pools capped. Simulate
+ * before signing, then read the Fleet back after confirmation.
+ * @example
+ * ```ts
+ * declare const ctx: SageContext, fleet: Address;
+ * const plan = await planSyncFleetWithGame(ctx, fleet);
+ * console.log(plan.describe());
+ * ```
+ */
+export async function planSyncFleetWithGame(ctx, fleet) {
+    const game = requireGameAddress(ctx);
+    const [[raw], current] = await Promise.all([
+        readContextRawAccounts(ctx, [fleet]),
+        readFreshGameShipDefinitionSequence(ctx),
+    ]);
+    if (!raw || raw.executable)
+        throw new SageSdkError('ACTION_PRECONDITION_FAILED', 'The selected Fleet is missing or executable. Refresh a valid Fleet and replan the sync.', { address: fleet });
+    const data = fleetAccountDefinition.decode(raw);
+    if (data.game !== game || (await deriveFleetAddress(data)) !== fleet)
+        throw new SageSdkError('ACTION_PRECONDITION_FAILED', `Fleet ${fleet} is not a canonical Fleet of the configured Game ${game}. Select a Fleet of this Game and replan the sync.`, { address: fleet });
+    const sequence = data.shipDefinitionsSeqId === current
+        ? `is already on ship definition sequence ${String(current)}, so only its AP, SP, HP and pending repair are capped at their maxima`
+        : `moves from ship definition sequence ${String(data.shipDefinitionsSeqId)} to ${String(current)}: its ship counts and stats are rebuilt from the current definitions, and its AP, SP, HP and pending repair are capped at the new maxima`;
+    const summary = `Sync Fleet ${data.name} (${fleet}) with Game ${game}. The Fleet ${sequence}. No Profile key signs it and no storage is funded; the fee payer is the only signer. Simulate before signing; the chain stays authoritative.`;
+    return buildPlannerPlan({
+        kind: 'fleets.sync-fleet-with-game',
+        summary,
+        preconditions: [],
+        steps: [
+            {
+                describes: summary,
+                instruction: syncFleetWithGameInstruction(game, fleet),
+                signers: [],
+            },
+        ],
+    });
+}
+//# sourceMappingURL=sync.js.map

package/dist/fleets/actions/sync.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync.js","sourceRoot":"","sources":["../../../src/fleets/actions/sync.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AACtD,OAAO,EAAE,sBAAsB,EAAE,MAAM,gCAAgC,CAAC;AACxE,OAAO,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAC;AACpE,OAAO,EACL,kBAAkB,EAClB,sBAAsB,GACvB,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAAE,4BAA4B,EAAE,MAAM,iCAAiC,CAAC;AAE/E,OAAO,EAAE,gBAAgB,EAAE,MAAM,qCAAqC,CAAC;AACvE,OAAO,EAAE,mCAAmC,EAAE,MAAM,yBAAyB,CAAC;AAE9E;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACzC,GAAgB,EAChB,KAAc;IAEd,MAAM,IAAI,GAAG,kBAAkB,CAAC,GAAG,CAAC,CAAC;IACrC,MAAM,CAAC,CAAC,GAAG,CAAC,EAAE,OAAO,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;QACzC,sBAAsB,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,CAAC;QACpC,mCAAmC,CAAC,GAAG,CAAC;KACzC,CAAC,CAAC;IACH,IAAI,CAAC,GAAG,IAAI,GAAG,CAAC,UAAU;QACxB,MAAM,IAAI,YAAY,CACpB,4BAA4B,EAC5B,yFAAyF,EACzF,EAAE,OAAO,EAAE,KAAK,EAAE,CACnB,CAAC;IACJ,MAAM,IAAI,GAAG,sBAAsB,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IAChD,IAAI,IAAI,CAAC,IAAI,KAAK,IAAI,IAAI,CAAC,MAAM,kBAAkB,CAAC,IAAI,CAAC,CAAC,KAAK,KAAK;QAClE,MAAM,IAAI,YAAY,CACpB,4BAA4B,EAC5B,SAAS,KAAK,oDAAoD,IAAI,oDAAoD,EAC1H,EAAE,OAAO,EAAE,KAAK,EAAE,CACnB,CAAC;IACJ,MAAM,QAAQ,GACZ,IAAI,CAAC,oBAAoB,KAAK,OAAO;QACnC,CAAC,CAAC,0CAA0C,MAAM,CAAC,OAAO,CAAC,wEAAwE;QACnI,CAAC,CAAC,uCAAuC,MAAM,CAAC,IAAI,CAAC,oBAAoB,CAAC,OAAO,MAAM,CAAC,OAAO,CAAC,0IAA0I,CAAC;IAC/O,MAAM,OAAO,GAAG,cAAc,IAAI,CAAC,IAAI,KAAK,KAAK,eAAe,IAAI,eAAe,QAAQ,+IAA+I,CAAC;IAC3O,OAAO,gBAAgB,CAAC;QACtB,IAAI,EAAE,6BAA6B;QACnC,OAAO;QACP,aAAa,EAAE,EAAE;QACjB,KAAK,EAAE;YACL;gBACE,SAAS,EAAE,OAAO;gBAClB,WAAW,EAAE,4BAA4B,CAAC,IAAI,EAAE,KAAK,CAAC;gBACtD,OAAO,EAAE,EAAE;aACZ;SACF;KACF,CAAC,CAAC;AACL,CAAC"}

package/dist/fleets/composition-stats.d.ts

@@ -0,0 +1,101 @@
+import type { FleetShipCountsData, FleetStatsData } from '../internal/c4/fleet.js';
+import type { ShipDefinitionSummary } from '../registry/index.js';
+/** Inputs for projecting a Fleet's stored stats after ship assembly. Pass the
+ * whole loaded ships section (`listShipConfigurations`), the current Fleet
+ * snapshot (omit it for a newly created, empty Fleet) and the ships to add, one
+ * entry per add-ship instruction in submission order, as successive
+ * `planAddShipToFleet` Plans would submit them.
+ * @example
+ * ```ts
+ * declare const ctx: SageContext, fleet: FleetSnapshot;
+ * const input: FleetCompositionStatsInput = {
+ *   definitions: await listShipConfigurations(ctx),
+ *   fleet,
+ *   additions: [{ shipId: 12, amount: 1n }],
+ * };
+ * ```
+ */
+export interface FleetCompositionStatsInput {
+    readonly definitions: readonly Pick<ShipDefinitionSummary, 'id' | 'sizeClass' | 'stats' | 'definitionSequenceId'>[];
+    /** A Fleet snapshot, or the same fields from raw Fleet data with
+     * `fleetShips` mapped to `{ id: shipId, quantity }`. */
+    readonly fleet?: {
+        readonly ships: readonly {
+            readonly id: number;
+            readonly quantity: bigint;
+        }[];
+        readonly shipCounts: FleetShipCountsData;
+        readonly stats: FleetStatsData;
+        readonly shipDefinitionsSeqId: number;
+    };
+    readonly additions: readonly {
+        readonly shipId: number;
+        readonly amount: bigint;
+    }[];
+}
+/** Projected stored Fleet stats after the additions, in the same units as a
+ * Fleet's `stats`. `route` says which program path produced them: `new-fleet`
+ * starts from an empty Fleet, `stored` builds on the Fleet's stored stats, and
+ * `resynchronized` first rebuilds a Fleet on an older ship-definition sequence
+ * from the current definitions, as the program does before adding ships.
+ * @example
+ * ```ts
+ * declare const projected: FleetCompositionStats;
+ * console.log(projected.route, projected.fleetPoints, projected.stats.cargo.miningRate.value);
+ * ```
+ */
+export interface FleetCompositionStats {
+    readonly route: 'new-fleet' | 'stored' | 'resynchronized';
+    readonly definitionSequenceId: number;
+    readonly ships: readonly {
+        readonly id: number;
+        readonly quantity: bigint;
+    }[];
+    readonly shipCounts: FleetShipCountsData;
+    /** XXS 1, XS 4, Small 9, Medium 16, Large 25, Capital 36, Commander 49, Titan 128. */
+    readonly fleetPoints: number;
+    readonly stats: FleetStatsData;
+    toJSON(): unknown;
+}
+/** Projects the stats a Fleet stores after ship assembly, exactly as the program
+ * aggregates them; verified against the program's behaviour. Capacities, Fuel
+ * and upkeep rates, mining and load rates, crew, AP/HP/SP and damage are added
+ * and capped. Subwarp, warp and lane speeds take the lowest value. Maximum warp
+ * distance, warp cooldown, warp spool, shield break delay, damage variance,
+ * respawn times and scan cooldown take the highest. Stealth, hit, aim and
+ * critical values are truncated per-ship averages, which the program rescales
+ * on every addition, so one addition of two ships can differ from two
+ * additions of one. Repair cost (weighted by hull points) and repair efficiency
+ * (weighted by repair ability) are recomputed over every ship aboard.
+ *
+ * A Fleet on the definitions' sequence builds on its stored stats and counts.
+ * One on an older sequence is first rebuilt from the current definitions of
+ * the ships aboard, as the program does before adding ships. A missing ship
+ * definition, mixed definition sequences, an amount outside 1n-255n or an
+ * overflow the program refuses throw `InvalidDerivationInputError`; other
+ * inputs are trusted as typed.
+ *
+ * Character research does not change stored stats: pass the Character's raw
+ * speed and cooldown modifiers to the travel helpers at use time. This is not
+ * an eligibility check (`planAddShipToFleet` applies ship size, research tags,
+ * Fleet size and formation limits), and checks no funding, entitlement or crew
+ * provisioning. Current AP, SP and HP are not projected. Read the Fleet back
+ * after confirmation; the chain stays authoritative. Requalify after program
+ * changes.
+ * @example
+ * ```ts
+ * declare const ctx: SageContext, fleet: FleetSnapshot, character: CharacterSnapshot;
+ * const projected = deriveFleetCompositionStats({
+ *   definitions: await listShipConfigurations(ctx),
+ *   fleet,
+ *   additions: [{ shipId: 12, amount: 1n }],
+ * });
+ * const travel = deriveFleetTravelProfile({
+ *   stats: projected.stats,
+ *   subwarpSpeedModifierRaw: character.modifiers.values.subwarpSpeedModifierRaw,
+ * });
+ * console.log(projected.stats.cargo.miningRate.value, travel.subwarp?.secondsPerAu);
+ * ```
+ */
+export declare function deriveFleetCompositionStats(input: FleetCompositionStatsInput): FleetCompositionStats;
+//# sourceMappingURL=composition-stats.d.ts.map

package/dist/fleets/composition-stats.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"composition-stats.d.ts","sourceRoot":"","sources":["../../src/fleets/composition-stats.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,mBAAmB,EACnB,cAAc,EACf,MAAM,yBAAyB,CAAC;AAIjC,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAElE;;;;;;;;;;;;;;GAcG;AACH,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,WAAW,EAAE,SAAS,IAAI,CACjC,qBAAqB,EACrB,IAAI,GAAG,WAAW,GAAG,OAAO,GAAG,sBAAsB,CACtD,EAAE,CAAC;IACJ;4DACwD;IACxD,QAAQ,CAAC,KAAK,CAAC,EAAE;QACf,QAAQ,CAAC,KAAK,EAAE,SAAS;YACvB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;YACpB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;SAC3B,EAAE,CAAC;QACJ,QAAQ,CAAC,UAAU,EAAE,mBAAmB,CAAC;QACzC,QAAQ,CAAC,KAAK,EAAE,cAAc,CAAC;QAC/B,QAAQ,CAAC,oBAAoB,EAAE,MAAM,CAAC;KACvC,CAAC;IACF,QAAQ,CAAC,SAAS,EAAE,SAAS;QAC3B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;QACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;KACzB,EAAE,CAAC;CACL;AAED;;;;;;;;;;GAUG;AACH,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,KAAK,EAAE,WAAW,GAAG,QAAQ,GAAG,gBAAgB,CAAC;IAC1D,QAAQ,CAAC,oBAAoB,EAAE,MAAM,CAAC;IACtC,QAAQ,CAAC,KAAK,EAAE,SAAS;QACvB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;QACpB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;KAC3B,EAAE,CAAC;IACJ,QAAQ,CAAC,UAAU,EAAE,mBAAmB,CAAC;IACzC,sFAAsF;IACtF,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,KAAK,EAAE,cAAc,CAAC;IAC/B,MAAM,IAAI,OAAO,CAAC;CACnB;AA6OD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AACH,wBAAgB,2BAA2B,CACzC,KAAK,EAAE,0BAA0B,GAChC,qBAAqB,CAwGvB"}

package/dist/fleets/composition-stats.js

@@ -0,0 +1,354 @@
+import { InvalidDerivationInputError } from '../client/index.js';
+import { fleetCapacityPoints } from '../internal/c4/fleet-points.js';
+import { attachJsonSerialization } from '../internal/json.js';
+import { freezeResolvedSnapshot } from '../internal/resolved-snapshot.js';
+const U32 = (1n << 32n) - 1n;
+const CONSUMPTION_U26F6 = 50000000n << 6n;
+const sum = (cap) => ({ kind: 'sum', cap });
+const max = { kind: 'max' };
+const speed = { kind: 'speed' };
+const average = { kind: 'average' };
+const checked = (maximum, minimum = 0n) => ({
+    kind: 'checked',
+    min: minimum,
+    max: maximum,
+});
+const damage = (name) => [
+    [`damage${name}`, sum(1000000n), 'number'],
+    [`damage${name}Variance`, max, 6],
+];
+// Verified against the program's ship-assembly behaviour.
+const FIELDS = {
+    movement: [
+        ['subwarpSpeed', speed, 16],
+        ['warpSpeed', speed, 16],
+        ['warpLaneSpeed', speed, 16],
+        ['maxWarpDistance', max, 8],
+        ['warpCoolDownSeconds', max, 'number'],
+        ['subwarpFuelConsumptionRate', sum(CONSUMPTION_U26F6), 6],
+        ['warpFuelConsumptionRate', sum(CONSUMPTION_U26F6), 6],
+        ['planetExitFuelAmount', sum(50000000n), 'number'],
+        ['warpXpRate', sum(U32), 16],
+        ['subwarpXpRate', sum(U32), 16],
+    ],
+    cargo: [
+        ['cargoCapacity', sum(100000000n), 'bigint'],
+        ['fuelCapacity', sum(100000000n), 'bigint'],
+        ['ammoCapacity', sum(1000000000n), 'bigint'],
+        ['ammoConsumptionRate', sum(U32), 14],
+        ['foodConsumptionRate', sum(U32), 14],
+        ['miningRate', sum(U32), 14],
+        ['loadRate', sum(CONSUMPTION_U26F6), 6],
+    ],
+    combat: [
+        ['ap', sum(1000000n), 'number'],
+        ['hp', sum(1000000n), 'number'],
+        ['sp', sum(1000000n), 'number'],
+        ['ammoConsumptionRate', sum(CONSUMPTION_U26F6), 6],
+        ['apRegenRate', sum(CONSUMPTION_U26F6), 6],
+        ['shieldRechargeRate', sum(CONSUMPTION_U26F6), 6],
+        ['repairRate', sum(CONSUMPTION_U26F6), 6],
+        ['repairAbility', sum(CONSUMPTION_U26F6), 6],
+        ['repairEfficiency', { kind: 'repairEfficiency' }, 6],
+        ['repairCost', { kind: 'repairCost' }, 6],
+        ['lootRate', sum(1000000n << 6n), 6],
+        ['shieldBreakDelaySeconds', max, 'number'],
+        ['warpSpoolTimeSeconds', max, 'number'],
+        ...[
+            'Kinetic',
+            'Energy',
+            'Emp',
+            'Superchill',
+            'Shockwave',
+            'Graygoo',
+            'Heat',
+            'Bomb',
+        ].flatMap(damage),
+        ...[
+            'Decoy',
+            'EnergyCapacitor',
+            'FireSuppressor',
+            'Flare',
+            'HealingNanobots',
+            'Mine',
+            'NegativeRemPlating',
+            'WarmingPlates',
+            'FaradayShielding',
+        ].map((name) => [`counter${name}`, sum(1000000n), 'number']),
+        ['stealthPower', average, 6],
+        ['hitChance', average, 6],
+        ['aimAbility', average, 6],
+        ['critChance', average, 6],
+        ['critMultiplier', average, 6],
+        ['fuelConsumptionRate', sum(CONSUMPTION_U26F6), 6],
+        ['missileDamage', sum(CONSUMPTION_U26F6), 6],
+        ['missileFireRate', sum(CONSUMPTION_U26F6), 6],
+    ],
+    misc: [
+        ['requiredCrew', checked(0xffffn), 'number'],
+        ['passengerCapacity', checked(0xffffn), 'number'],
+        ['respawnTimeWithoutFeeSeconds', max, 'number'],
+        ['respawnTimeWithFeeSeconds', max, 'number'],
+        ['recoveryFeeRaw', checked((1n << 64n) - 1n), 'bigint'],
+        ['scanCoolDownSeconds', max, 16],
+        ['scanPower', sum(U32), 6],
+        ['scanCost', sum(50000000n), 'number'],
+        ['scanBonus', checked((1n << 31n) - 1n, -(1n << 31n)), 16],
+        ['lpValue', checked(U32), 'number'],
+        ['medallionValue', checked(U32), 'number'],
+        ['xpValue', sum(U32), 16],
+    ],
+};
+const GROUPS = Object.keys(FIELDS);
+const SIZE_KEYS = {
+    'xx-small': 'xxSmall',
+    'x-small': 'xSmall',
+    small: 'small',
+    medium: 'medium',
+    large: 'large',
+    capital: 'capital',
+    commander: 'commander',
+    titan: 'titan',
+};
+function invalid(field, value) {
+    throw new InvalidDerivationInputError(field, value, 'Pass one current ships section from listShipConfigurations and amounts of 1n-255n; the program refuses this addition.');
+}
+function readRaw(stats) {
+    const raw = {};
+    for (const group of GROUPS) {
+        const translated = stats[group];
+        raw[group] = Object.fromEntries(FIELDS[group].map(([name]) => {
+            const value = translated[name];
+            return [name, typeof value === 'object' ? value.raw : BigInt(value)];
+        }));
+    }
+    return raw;
+}
+function emptyRaw() {
+    const raw = {};
+    for (const group of GROUPS)
+        raw[group] = Object.fromEntries(FIELDS[group].map(([name]) => [name, 0n]));
+    return raw;
+}
+function combine(target, ship, amount) {
+    for (const group of GROUPS)
+        for (const [name, rule] of FIELDS[group]) {
+            const current = target[group][name];
+            const incoming = ship[group][name];
+            let next;
+            switch (rule.kind) {
+                case 'sum':
+                    next = minimum(current + minimum(incoming * amount, rule.cap), rule.cap);
+                    break;
+                case 'average':
+                    next = minimum(current + minimum(incoming * amount, CONSUMPTION_U26F6), CONSUMPTION_U26F6);
+                    break;
+                case 'checked': {
+                    const scaled = incoming * amount;
+                    next = current + scaled;
+                    for (const value of [scaled, next])
+                        if (value < rule.min || value > rule.max)
+                            invalid(`${group}.${name}`, value);
+                    break;
+                }
+                case 'speed':
+                    next = current === 0n ? incoming : minimum(current, incoming);
+                    break;
+                default:
+                    next = current > incoming ? current : incoming;
+            }
+            target[group][name] = next;
+        }
+}
+function scaleAverages(stats, factor, divide) {
+    if (factor <= 1n)
+        return;
+    for (const [name, rule] of FIELDS.combat)
+        if (rule.kind === 'average') {
+            const value = stats.combat[name];
+            stats.combat[name] = divide
+                ? value / factor
+                : minimum(value * factor, CONSUMPTION_U26F6);
+        }
+}
+function minimum(left, right) {
+    return left < right ? left : right;
+}
+function writeStats(raw) {
+    const stats = {};
+    for (const group of GROUPS) {
+        const values = {};
+        for (const [name, , shape] of FIELDS[group]) {
+            const value = raw[group][name];
+            values[name] =
+                shape === 'bigint'
+                    ? value
+                    : shape === 'number'
+                        ? Number(value)
+                        : { raw: value, value: Number(value) / 2 ** shape };
+        }
+        stats[group] = values;
+    }
+    stats.misc.recoveryFeeAtlas = Number(raw.misc.recoveryFeeRaw) / 100_000_000;
+    return stats;
+}
+/** Projects the stats a Fleet stores after ship assembly, exactly as the program
+ * aggregates them; verified against the program's behaviour. Capacities, Fuel
+ * and upkeep rates, mining and load rates, crew, AP/HP/SP and damage are added
+ * and capped. Subwarp, warp and lane speeds take the lowest value. Maximum warp
+ * distance, warp cooldown, warp spool, shield break delay, damage variance,
+ * respawn times and scan cooldown take the highest. Stealth, hit, aim and
+ * critical values are truncated per-ship averages, which the program rescales
+ * on every addition, so one addition of two ships can differ from two
+ * additions of one. Repair cost (weighted by hull points) and repair efficiency
+ * (weighted by repair ability) are recomputed over every ship aboard.
+ *
+ * A Fleet on the definitions' sequence builds on its stored stats and counts.
+ * One on an older sequence is first rebuilt from the current definitions of
+ * the ships aboard, as the program does before adding ships. A missing ship
+ * definition, mixed definition sequences, an amount outside 1n-255n or an
+ * overflow the program refuses throw `InvalidDerivationInputError`; other
+ * inputs are trusted as typed.
+ *
+ * Character research does not change stored stats: pass the Character's raw
+ * speed and cooldown modifiers to the travel helpers at use time. This is not
+ * an eligibility check (`planAddShipToFleet` applies ship size, research tags,
+ * Fleet size and formation limits), and checks no funding, entitlement or crew
+ * provisioning. Current AP, SP and HP are not projected. Read the Fleet back
+ * after confirmation; the chain stays authoritative. Requalify after program
+ * changes.
+ * @example
+ * ```ts
+ * declare const ctx: SageContext, fleet: FleetSnapshot, character: CharacterSnapshot;
+ * const projected = deriveFleetCompositionStats({
+ *   definitions: await listShipConfigurations(ctx),
+ *   fleet,
+ *   additions: [{ shipId: 12, amount: 1n }],
+ * });
+ * const travel = deriveFleetTravelProfile({
+ *   stats: projected.stats,
+ *   subwarpSpeedModifierRaw: character.modifiers.values.subwarpSpeedModifierRaw,
+ * });
+ * console.log(projected.stats.cargo.miningRate.value, travel.subwarp?.secondsPerAu);
+ * ```
+ */
+export function deriveFleetCompositionStats(input) {
+    const definitions = new Map();
+    let sequence;
+    for (const definition of input.definitions) {
+        sequence ??= definition.definitionSequenceId;
+        if (definition.definitionSequenceId !== sequence)
+            invalid('Ship definition sequence', definition.definitionSequenceId);
+        definitions.set(definition.id, definition);
+    }
+    if (sequence === undefined)
+        invalid('Ship definitions', 0);
+    const rawDefinitions = new Map();
+    const lookup = (id) => {
+        const definition = definitions.get(id);
+        if (definition === undefined)
+            invalid('Ship definition id', id);
+        let raw = rawDefinitions.get(id);
+        if (raw === undefined) {
+            raw = readRaw(definition.stats);
+            rawDefinitions.set(id, raw);
+        }
+        return { definition, raw };
+    };
+    const fleet = input.fleet;
+    const ships = new Map(fleet?.ships.map(({ id, quantity }) => [id, quantity]));
+    const counts = {
+        total: 0n,
+        xxSmall: 0n,
+        xSmall: 0n,
+        small: 0n,
+        medium: 0n,
+        large: 0n,
+        capital: 0n,
+        commander: 0n,
+        titan: 0n,
+    };
+    const addCounts = (definition, amount) => {
+        const key = SIZE_KEYS[definition.sizeClass];
+        counts[key] += amount;
+        counts.total += amount;
+        if (counts[key] > 0xffffn)
+            invalid(`shipCounts.${key}`, counts[key]);
+    };
+    let route;
+    let stats;
+    if (fleet === undefined) {
+        route = 'new-fleet';
+        stats = emptyRaw();
+    }
+    else {
+        stats = readRaw(fleet.stats);
+        for (const key of Object.keys(counts))
+            counts[key] = BigInt(fleet.shipCounts[key]);
+        if (fleet.shipDefinitionsSeqId === sequence)
+            route = 'stored';
+        else {
+            route = 'resynchronized';
+            if (ships.size > 0) {
+                stats = emptyRaw();
+                for (const key of Object.keys(counts))
+                    counts[key] = 0n;
+                for (const [id, quantity] of ships) {
+                    const { definition, raw } = lookup(id);
+                    addCounts(definition, quantity);
+                    combine(stats, raw, quantity);
+                }
+                scaleAverages(stats, counts.total, true);
+                setRepair(stats, ships, lookup);
+            }
+        }
+    }
+    for (const { shipId, amount } of input.additions) {
+        if (amount < 1n || amount > 255n)
+            invalid('Addition amount', amount);
+        const { definition, raw } = lookup(shipId);
+        scaleAverages(stats, counts.total, false);
+        combine(stats, raw, amount);
+        addCounts(definition, amount);
+        ships.set(shipId, (ships.get(shipId) ?? 0n) + amount);
+        scaleAverages(stats, counts.total, true);
+        setRepair(stats, ships, lookup);
+    }
+    const shipCounts = Object.fromEntries(Object.entries(counts).map(([key, value]) => [key, Number(value)]));
+    return freezeResolvedSnapshot(attachJsonSerialization({
+        route,
+        definitionSequenceId: sequence,
+        ships: [...ships].map(([id, quantity]) => ({ id, quantity })),
+        shipCounts,
+        fleetPoints: fleetCapacityPoints([
+            shipCounts.xxSmall,
+            shipCounts.xSmall,
+            shipCounts.small,
+            shipCounts.medium,
+            shipCounts.large,
+            shipCounts.capital,
+            shipCounts.commander,
+            shipCounts.titan,
+        ]),
+        stats: writeStats(stats),
+    }));
+}
+function setRepair(stats, ships, lookup) {
+    let costWeighted = 0n;
+    let hullWeight = 0n;
+    let efficiencyWeighted = 0n;
+    let abilityWeight = 0n;
+    for (const [id, quantity] of ships) {
+        const { combat } = lookup(id).raw;
+        const hull = combat.hp * quantity;
+        const ability = combat.repairAbility * quantity;
+        hullWeight += hull;
+        costWeighted += combat.repairCost * hull;
+        abilityWeight += ability;
+        efficiencyWeighted += combat.repairEfficiency * ability;
+    }
+    stats.combat.repairCost = hullWeight === 0n ? 0n : costWeighted / hullWeight;
+    stats.combat.repairEfficiency =
+        abilityWeight === 0n ? 0n : efficiencyWeighted / abilityWeight;
+}
+//# sourceMappingURL=composition-stats.js.map

package/dist/fleets/composition-stats.js.map

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

package/dist/fleets/cooldown.d.ts

@@ -16,19 +16,22 @@ export type FleetMovementCooldownInput = {
 } | {
     readonly kind: 'warpLane';
     readonly departsAtUnixSeconds: bigint;
+    readonly existingCooldownExpiresAt: bigint;
 } | {
     readonly kind: 'subwarp';
     readonly existingCooldownExpiresAt: bigint;
 };
 /** Predicts the assigned warp-cooldown expiry in Unix seconds for a movement.
  * Coordinate warp anchors at arrival and rounds the modified base upward;
- * a zero modifier uses the unmodified base. Lane warp assigns departure time,
- * replacing even a later expiry. Subwarp preserves the existing expiry.
+ * a zero modifier uses the unmodified base. Lane warp adds no cooldown but
+ * never erases an active one: the expiry becomes the later of the existing
+ * expiry and the departure time. Subwarp preserves the existing expiry.
  *
- * Qualified against PTR deployment slot 54356023. Coordinate/lane timestamps
+ * Coordinate-warp arithmetic is qualified against PTR deployment slot
+ * 54356023; the lane rule follows the current program. Coordinate/lane timestamps
  * must be nonnegative signed-i64 values, base seconds an integer in 0..65535,
  * and modifier raw a nonnegative signed-i64 value. Overflow is rejected.
- * Existing subwarp expiry may be any signed-i64 value, including sentinels.
+ * An existing expiry may be any signed-i64 value, including sentinels.
  * This pure helper does not calculate journey duration or check state, active
  * cooldown, permissions, Fuel or lane eligibility. Use deriveFleetTimers for
  * observed timer display and simulate the intended action before signing.

package/dist/fleets/cooldown.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cooldown.d.ts","sourceRoot":"","sources":["../../src/fleets/cooldown.ts"],"names":[],"mappings":"AAEA;;;;;;;;;GASG;AACH,MAAM,MAAM,0BAA0B,GAClC;IACE,QAAQ,CAAC,IAAI,EAAE,gBAAgB,CAAC;IAChC,QAAQ,CAAC,oBAAoB,EAAE,MAAM,CAAC;IACtC,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAC;IACrC,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAC;CACtC,GACD;IAAE,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAAC,QAAQ,CAAC,oBAAoB,EAAE,MAAM,CAAA;CAAE,GACpE;IAAE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IAAC,QAAQ,CAAC,yBAAyB,EAAE,MAAM,CAAA;CAAE,CAAC;AAY7E;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,2BAA2B,CACzC,KAAK,EAAE,0BAA0B,GAChC,MAAM,CA2BR"}
+{"version":3,"file":"cooldown.d.ts","sourceRoot":"","sources":["../../src/fleets/cooldown.ts"],"names":[],"mappings":"AAEA;;;;;;;;;GASG;AACH,MAAM,MAAM,0BAA0B,GAClC;IACE,QAAQ,CAAC,IAAI,EAAE,gBAAgB,CAAC;IAChC,QAAQ,CAAC,oBAAoB,EAAE,MAAM,CAAC;IACtC,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAC;IACrC,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAC;CACtC,GACD;IACE,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAC1B,QAAQ,CAAC,oBAAoB,EAAE,MAAM,CAAC;IACtC,QAAQ,CAAC,yBAAyB,EAAE,MAAM,CAAC;CAC5C,GACD;IAAE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IAAC,QAAQ,CAAC,yBAAyB,EAAE,MAAM,CAAA;CAAE,CAAC;AAY7E;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,2BAA2B,CACzC,KAAK,EAAE,0BAA0B,GAChC,MAAM,CAqCR"}

package/dist/fleets/cooldown.js

@@ -9,13 +9,15 @@ function bounded(field, value, minimum = 0n) {
 }
 /** Predicts the assigned warp-cooldown expiry in Unix seconds for a movement.
  * Coordinate warp anchors at arrival and rounds the modified base upward;
- * a zero modifier uses the unmodified base. Lane warp assigns departure time,
- * replacing even a later expiry. Subwarp preserves the existing expiry.
+ * a zero modifier uses the unmodified base. Lane warp adds no cooldown but
+ * never erases an active one: the expiry becomes the later of the existing
+ * expiry and the departure time. Subwarp preserves the existing expiry.
  *
- * Qualified against PTR deployment slot 54356023. Coordinate/lane timestamps
+ * Coordinate-warp arithmetic is qualified against PTR deployment slot
+ * 54356023; the lane rule follows the current program. Coordinate/lane timestamps
  * must be nonnegative signed-i64 values, base seconds an integer in 0..65535,
  * and modifier raw a nonnegative signed-i64 value. Overflow is rejected.
- * Existing subwarp expiry may be any signed-i64 value, including sentinels.
+ * An existing expiry may be any signed-i64 value, including sentinels.
  * This pure helper does not calculate journey duration or check state, active
  * cooldown, permissions, Fuel or lane eligibility. Use deriveFleetTimers for
  * observed timer display and simulate the intended action before signing.
@@ -30,8 +32,11 @@ function bounded(field, value, minimum = 0n) {
 export function deriveFleetMovementCooldown(input) {
     if (input.kind === 'subwarp')
         return bounded('Existing warp cooldown expiry', input.existingCooldownExpiresAt, -(1n << 63n));
-    if (input.kind === 'warpLane')
-        return bounded('Warp-lane departure timestamp', input.departsAtUnixSeconds);
+    if (input.kind === 'warpLane') {
+        const departure = bounded('Warp-lane departure timestamp', input.departsAtUnixSeconds);
+        const existing = bounded('Existing warp cooldown expiry', input.existingCooldownExpiresAt, -(1n << 63n));
+        return existing > departure ? existing : departure;
+    }
     const arrival = bounded('Coordinate-warp arrival timestamp', input.arrivesAtUnixSeconds);
     const base = input.baseCooldownSeconds;
     if (!Number.isInteger(base) || base < 0 || base > 65535)

package/dist/fleets/cooldown.js.map

@@ -1 +1 @@
-{"version":3,"file":"cooldown.js","sourceRoot":"","sources":["../../src/fleets/cooldown.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,2BAA2B,EAAE,MAAM,oBAAoB,CAAC;AAsBjE,MAAM,YAAY,GAAG,CAAC,EAAE,IAAI,GAAG,CAAC,GAAG,EAAE,CAAC;AACtC,MAAM,KAAK,GAAG,EAAE,IAAI,GAAG,CAAC;AACxB,MAAM,MAAM,GACV,yIAAyI,CAAC;AAC5I,SAAS,OAAO,CAAC,KAAa,EAAE,KAAa,EAAE,OAAO,GAAG,EAAE;IACzD,IAAI,KAAK,GAAG,OAAO,IAAI,KAAK,GAAG,YAAY;QACzC,MAAM,IAAI,2BAA2B,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC;IAC9D,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,UAAU,2BAA2B,CACzC,KAAiC;IAEjC,IAAI,KAAK,CAAC,IAAI,KAAK,SAAS;QAC1B,OAAO,OAAO,CACZ,+BAA+B,EAC/B,KAAK,CAAC,yBAAyB,EAC/B,CAAC,CAAC,EAAE,IAAI,GAAG,CAAC,CACb,CAAC;IACJ,IAAI,KAAK,CAAC,IAAI,KAAK,UAAU;QAC3B,OAAO,OAAO,CAAC,+BAA+B,EAAE,KAAK,CAAC,oBAAoB,CAAC,CAAC;IAC9E,MAAM,OAAO,GAAG,OAAO,CACrB,mCAAmC,EACnC,KAAK,CAAC,oBAAoB,CAC3B,CAAC;IACF,MAAM,IAAI,GAAG,KAAK,CAAC,mBAAmB,CAAC;IACvC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,IAAI,GAAG,CAAC,IAAI,IAAI,GAAG,KAAK;QACrD,MAAM,IAAI,2BAA2B,CACnC,4BAA4B,EAC5B,IAAI,EACJ,MAAM,CACP,CAAC;IACJ,MAAM,QAAQ,GAAG,OAAO,CACtB,sCAAsC,EACtC,KAAK,CAAC,mBAAmB,CAC1B,CAAC;IACF,MAAM,QAAQ,GACZ,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,QAAQ,KAAK,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,GAAG,KAAK,GAAG,EAAE,CAAC,GAAG,KAAK,CAAC;IAC7E,OAAO,OAAO,CAAC,gCAAgC,EAAE,OAAO,GAAG,QAAQ,CAAC,CAAC;AACvE,CAAC"}
+{"version":3,"file":"cooldown.js","sourceRoot":"","sources":["../../src/fleets/cooldown.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,2BAA2B,EAAE,MAAM,oBAAoB,CAAC;AA0BjE,MAAM,YAAY,GAAG,CAAC,EAAE,IAAI,GAAG,CAAC,GAAG,EAAE,CAAC;AACtC,MAAM,KAAK,GAAG,EAAE,IAAI,GAAG,CAAC;AACxB,MAAM,MAAM,GACV,yIAAyI,CAAC;AAC5I,SAAS,OAAO,CAAC,KAAa,EAAE,KAAa,EAAE,OAAO,GAAG,EAAE;IACzD,IAAI,KAAK,GAAG,OAAO,IAAI,KAAK,GAAG,YAAY;QACzC,MAAM,IAAI,2BAA2B,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC;IAC9D,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,UAAU,2BAA2B,CACzC,KAAiC;IAEjC,IAAI,KAAK,CAAC,IAAI,KAAK,SAAS;QAC1B,OAAO,OAAO,CACZ,+BAA+B,EAC/B,KAAK,CAAC,yBAAyB,EAC/B,CAAC,CAAC,EAAE,IAAI,GAAG,CAAC,CACb,CAAC;IACJ,IAAI,KAAK,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;QAC9B,MAAM,SAAS,GAAG,OAAO,CACvB,+BAA+B,EAC/B,KAAK,CAAC,oBAAoB,CAC3B,CAAC;QACF,MAAM,QAAQ,GAAG,OAAO,CACtB,+BAA+B,EAC/B,KAAK,CAAC,yBAAyB,EAC/B,CAAC,CAAC,EAAE,IAAI,GAAG,CAAC,CACb,CAAC;QACF,OAAO,QAAQ,GAAG,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC;IACrD,CAAC;IACD,MAAM,OAAO,GAAG,OAAO,CACrB,mCAAmC,EACnC,KAAK,CAAC,oBAAoB,CAC3B,CAAC;IACF,MAAM,IAAI,GAAG,KAAK,CAAC,mBAAmB,CAAC;IACvC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,IAAI,GAAG,CAAC,IAAI,IAAI,GAAG,KAAK;QACrD,MAAM,IAAI,2BAA2B,CACnC,4BAA4B,EAC5B,IAAI,EACJ,MAAM,CACP,CAAC;IACJ,MAAM,QAAQ,GAAG,OAAO,CACtB,sCAAsC,EACtC,KAAK,CAAC,mBAAmB,CAC1B,CAAC;IACF,MAAM,QAAQ,GACZ,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,QAAQ,KAAK,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,GAAG,KAAK,GAAG,EAAE,CAAC,GAAG,KAAK,CAAC;IAC7E,OAAO,OAAO,CAAC,gCAAgC,EAAE,OAAO,GAAG,QAAQ,CAAC,CAAC;AACvE,CAAC"}

package/dist/fleets/index.d.ts

@@ -4,6 +4,7 @@ export { deriveFleetWarpLaneEstimate, type FleetWarpLaneEstimate, type FleetWarp
 export { deriveFleetCoordinateWarpEstimate, type FleetCoordinateWarpEstimate, type FleetCoordinateWarpEstimateInput, } from './coordinate-warp-estimate.js';
 export { deriveFleetSubwarpEstimate, type FleetSubwarpEstimate, type FleetSubwarpEstimateInput, } from './subwarp-estimate.js';
 export { deriveFleetMovementCooldown, type FleetMovementCooldownInput, } from './cooldown.js';
+export { deriveFleetCompositionStats, type FleetCompositionStats, type FleetCompositionStatsInput, } from './composition-stats.js';
 export { deriveFleetTravelProfile, type FleetTravelProfile, type FleetTravelProfileInput, } from './travel-profile.js';
 import { SageSdkError, type Address, type DiscoveryRequest, type EntityRef, type ReadOptions, type SageContext, type SageSubscription, type SubscriptionDiagnosticEvent, type SubscriptionOptions } from '../client/index.js';
 import { deriveFleetTimers, interpolateSubwarpPosition, type ResolvedFleetAccountData } from '../internal/fleet.js';