eve-fit-engine 0.1.2 → 0.1.4

package/README.md

@@ -25,7 +25,7 @@ projected effects, and structure fuel/service stats.
     release gate and the engine's correctness ground truth.
   - **Differential harness** — `npm run diff`: generates 4 fits for *every*
     published ship and compares every stat against a headless **pyfa-org/Pyfa**
-    oracle. 1646/1676 fits (98.2%) match exactly; the residual is a documented
+    oracle. 1662/1676 fits (99.2%) match exactly; the residual is a documented
     set of pyfa float/modelling/per-ship quirks (see
     [`test/diff/known-diffs.mjs`](test/diff/known-diffs.mjs)). Exits 0 on no
     *unexpected* diffs; `--strict` re-lists the accepted set as failures.
@@ -99,6 +99,13 @@ tracked and ported, then re-checked against **both** the fixture suite
 (`npm run test:pyfa`) and the per-ship differential harness (`npm run diff`)
 before release. See [`MAINTENANCE.md`](./MAINTENANCE.md) for the update flows.
 
+## Contributing
+
+See [`CONTRIBUTING.md`](./CONTRIBUTING.md) — the step-by-step guide to setup,
+every internal command, the two validation suites (`npm run test:pyfa` +
+`npm run diff`), how to add fixtures / port effects, the pyfa-pin recalibration
+flow, and the project's hard rules.
+
 ## Licence
 
 GPL-3.0-or-later. Copyright (C) 2026 Capsuleers.app. This is free software; see

package/dist/index.cjs

@@ -232,6 +232,8 @@ var ATTR = {
   EXPLOSION_RADIUS: 654,
   DRF: 858,
   // damage reduction factor
+  EXPLOSION_DELAY: 281,
+  // charge attr — "Maximum Flight Time" (ms); range = maxVelocity × flightTime/1000
   // ---- Breacher Pods (DOT charges, e.g. SCARAB Breacher Pod M) ----
   DOT_DURATION: 5735,
   // ms
@@ -4217,11 +4219,15 @@ function collectDrains(ctx, dataset) {
       }
       continue;
     }
+    const seen = /* @__PURE__ */ new Set();
     for (const eid of m.effectIDs) {
       const effect = dataset.effects.get(eid);
       if (!effect) continue;
       const entry = drainEntryFromEffect(effect, m);
       if (!entry) continue;
+      const sig = `${entry.cycleMs}|${entry.capNeed}|${entry.clipSize}|${entry.reloadMs}|${entry.isInjector ? 1 : 0}|${entry.disableStagger ? 1 : 0}`;
+      if (seen.has(sig)) continue;
+      seen.add(sig);
       drains.push(entry);
       if (entry.capNeed > 0 && entry.cycleMs > 0) {
         totalGrossDrain += entry.capNeed / (entry.cycleMs / 1e3);
@@ -4651,10 +4657,14 @@ function readRangeInfo(item, effect, kind) {
   let explosionRadius = 0;
   let explosionVelocity = 0;
   let drf = 0;
+  let flightRange = 0;
   if (kind === "MISSILE" && item.charge) {
     explosionRadius = item.charge.getFinal(ATTR.EXPLOSION_RADIUS, 0);
     explosionVelocity = item.charge.getFinal(ATTR.EXPLOSION_VELOCITY, 0);
     drf = item.charge.getFinal(ATTR.DRF, 0);
+    const velocity = item.charge.getFinal(ATTR.MAX_VELOCITY, 0);
+    const flightMs = item.charge.getFinal(ATTR.EXPLOSION_DELAY, 0);
+    flightRange = velocity * flightMs / 1e3;
   }
   return {
     optimal,
@@ -4663,7 +4673,8 @@ function readRangeInfo(item, effect, kind) {
     burstRange,
     explosionRadius,
     explosionVelocity,
-    drf
+    drf,
+    flightRange
   };
 }
 
@@ -4744,6 +4755,7 @@ function computeOffense(ctx, dataset, fit) {
   const weaponTracking = turretContribs.length > 0 ? Math.min(...turretContribs.map((c) => c.range.tracking).filter((v) => v > 0)) : void 0;
   const explosionVelocity = missileContribs.length > 0 ? missileContribs[0].range.explosionVelocity : void 0;
   const explosionRadius = missileContribs.length > 0 ? missileContribs[0].range.explosionRadius : void 0;
+  const missileRange = missileContribs.length > 0 ? Math.max(...missileContribs.map((c) => c.range.flightRange).filter((v) => v > 0)) : void 0;
   return {
     weaponDps,
     weaponSustainedDps,
@@ -4757,6 +4769,7 @@ function computeOffense(ctx, dataset, fit) {
     weaponTracking,
     explosionVelocity,
     explosionRadius,
+    missileRange: missileRange != null && Number.isFinite(missileRange) ? missileRange : void 0,
     breakdown
   };
 }
@@ -4825,7 +4838,8 @@ function fighterContributionFor(fighter, count, _ctx, dataset) {
       burstRange: 0,
       explosionRadius: fighter.getFinal(2125, 0),
       explosionVelocity: fighter.getFinal(2126, 0),
-      drf: fighter.getFinal(2127, 0)
+      drf: fighter.getFinal(2127, 0),
+      flightRange: 0
     },
     count
   };
@@ -5457,6 +5471,7 @@ function deriveStats(ctx, dataset, damageProfile, fit, projectionReports) {
       weaponTracking: offense.weaponTracking,
       explosionVelocity: offense.explosionVelocity,
       explosionRadius: offense.explosionRadius,
+      missileRange: offense.missileRange,
       breakdown: offense.breakdown
     },
     capacitor: {

package/dist/index.d.cts

@@ -464,6 +464,7 @@ interface DerivedStats {
         weaponTracking?: number;
         explosionVelocity?: number;
         explosionRadius?: number;
+        missileRange?: number;
         breakdown: WeaponContribution[];
     };
     capacitor: {
@@ -652,6 +653,7 @@ interface WeaponContribution {
         explosionRadius: number;
         explosionVelocity: number;
         drf: number;
+        flightRange: number;
     };
     chargeTypeID?: number;
     count: number;
@@ -1025,6 +1027,7 @@ declare const ATTR: {
     readonly EXPLOSION_VELOCITY: 653;
     readonly EXPLOSION_RADIUS: 654;
     readonly DRF: 858;
+    readonly EXPLOSION_DELAY: 281;
     readonly DOT_DURATION: 5735;
     readonly DOT_MAX_DAMAGE_PER_TICK: 5736;
     readonly DOT_MAX_HP_PERCENTAGE_PER_TICK: 5737;
@@ -1756,6 +1759,9 @@ interface OffenseReport {
     weaponTracking?: number;
     explosionVelocity?: number;
     explosionRadius?: number;
+    /** Missile max flight range (m) — modified velocity × flight time. The
+     *  missile equivalent of `weaponOptimal`. Undefined for non-missile fits. */
+    missileRange?: number;
     breakdown: WeaponContribution[];
 }
 declare function computeOffense(ctx: FitContext, dataset: FittingDataset, fit: {
@@ -1891,6 +1897,9 @@ interface WeaponRangeInfo {
     explosionVelocity: number;
     /** Missile-specific: damage reduction factor (DRF). */
     drf: number;
+    /** Missile-specific: max flight range in meters — modified charge
+     *  velocity × flight time (ship/skill/rig bonuses included). 0 otherwise. */
+    flightRange: number;
 }
 declare function readRangeInfo(item: ItemState, effect: SdeEffect, kind: WeaponEffectKind): WeaponRangeInfo;
 

package/dist/index.d.ts

@@ -464,6 +464,7 @@ interface DerivedStats {
         weaponTracking?: number;
         explosionVelocity?: number;
         explosionRadius?: number;
+        missileRange?: number;
         breakdown: WeaponContribution[];
     };
     capacitor: {
@@ -652,6 +653,7 @@ interface WeaponContribution {
         explosionRadius: number;
         explosionVelocity: number;
         drf: number;
+        flightRange: number;
     };
     chargeTypeID?: number;
     count: number;
@@ -1025,6 +1027,7 @@ declare const ATTR: {
     readonly EXPLOSION_VELOCITY: 653;
     readonly EXPLOSION_RADIUS: 654;
     readonly DRF: 858;
+    readonly EXPLOSION_DELAY: 281;
     readonly DOT_DURATION: 5735;
     readonly DOT_MAX_DAMAGE_PER_TICK: 5736;
     readonly DOT_MAX_HP_PERCENTAGE_PER_TICK: 5737;
@@ -1756,6 +1759,9 @@ interface OffenseReport {
     weaponTracking?: number;
     explosionVelocity?: number;
     explosionRadius?: number;
+    /** Missile max flight range (m) — modified velocity × flight time. The
+     *  missile equivalent of `weaponOptimal`. Undefined for non-missile fits. */
+    missileRange?: number;
     breakdown: WeaponContribution[];
 }
 declare function computeOffense(ctx: FitContext, dataset: FittingDataset, fit: {
@@ -1891,6 +1897,9 @@ interface WeaponRangeInfo {
     explosionVelocity: number;
     /** Missile-specific: damage reduction factor (DRF). */
     drf: number;
+    /** Missile-specific: max flight range in meters — modified charge
+     *  velocity × flight time (ship/skill/rig bonuses included). 0 otherwise. */
+    flightRange: number;
 }
 declare function readRangeInfo(item: ItemState, effect: SdeEffect, kind: WeaponEffectKind): WeaponRangeInfo;
 

package/dist/index.js

@@ -230,6 +230,8 @@ var ATTR = {
   EXPLOSION_RADIUS: 654,
   DRF: 858,
   // damage reduction factor
+  EXPLOSION_DELAY: 281,
+  // charge attr — "Maximum Flight Time" (ms); range = maxVelocity × flightTime/1000
   // ---- Breacher Pods (DOT charges, e.g. SCARAB Breacher Pod M) ----
   DOT_DURATION: 5735,
   // ms
@@ -4215,11 +4217,15 @@ function collectDrains(ctx, dataset) {
       }
       continue;
     }
+    const seen = /* @__PURE__ */ new Set();
     for (const eid of m.effectIDs) {
       const effect = dataset.effects.get(eid);
       if (!effect) continue;
       const entry = drainEntryFromEffect(effect, m);
       if (!entry) continue;
+      const sig = `${entry.cycleMs}|${entry.capNeed}|${entry.clipSize}|${entry.reloadMs}|${entry.isInjector ? 1 : 0}|${entry.disableStagger ? 1 : 0}`;
+      if (seen.has(sig)) continue;
+      seen.add(sig);
       drains.push(entry);
       if (entry.capNeed > 0 && entry.cycleMs > 0) {
         totalGrossDrain += entry.capNeed / (entry.cycleMs / 1e3);
@@ -4649,10 +4655,14 @@ function readRangeInfo(item, effect, kind) {
   let explosionRadius = 0;
   let explosionVelocity = 0;
   let drf = 0;
+  let flightRange = 0;
   if (kind === "MISSILE" && item.charge) {
     explosionRadius = item.charge.getFinal(ATTR.EXPLOSION_RADIUS, 0);
     explosionVelocity = item.charge.getFinal(ATTR.EXPLOSION_VELOCITY, 0);
     drf = item.charge.getFinal(ATTR.DRF, 0);
+    const velocity = item.charge.getFinal(ATTR.MAX_VELOCITY, 0);
+    const flightMs = item.charge.getFinal(ATTR.EXPLOSION_DELAY, 0);
+    flightRange = velocity * flightMs / 1e3;
   }
   return {
     optimal,
@@ -4661,7 +4671,8 @@ function readRangeInfo(item, effect, kind) {
     burstRange,
     explosionRadius,
     explosionVelocity,
-    drf
+    drf,
+    flightRange
   };
 }
 
@@ -4742,6 +4753,7 @@ function computeOffense(ctx, dataset, fit) {
   const weaponTracking = turretContribs.length > 0 ? Math.min(...turretContribs.map((c) => c.range.tracking).filter((v) => v > 0)) : void 0;
   const explosionVelocity = missileContribs.length > 0 ? missileContribs[0].range.explosionVelocity : void 0;
   const explosionRadius = missileContribs.length > 0 ? missileContribs[0].range.explosionRadius : void 0;
+  const missileRange = missileContribs.length > 0 ? Math.max(...missileContribs.map((c) => c.range.flightRange).filter((v) => v > 0)) : void 0;
   return {
     weaponDps,
     weaponSustainedDps,
@@ -4755,6 +4767,7 @@ function computeOffense(ctx, dataset, fit) {
     weaponTracking,
     explosionVelocity,
     explosionRadius,
+    missileRange: missileRange != null && Number.isFinite(missileRange) ? missileRange : void 0,
     breakdown
   };
 }
@@ -4823,7 +4836,8 @@ function fighterContributionFor(fighter, count, _ctx, dataset) {
       burstRange: 0,
       explosionRadius: fighter.getFinal(2125, 0),
       explosionVelocity: fighter.getFinal(2126, 0),
-      drf: fighter.getFinal(2127, 0)
+      drf: fighter.getFinal(2127, 0),
+      flightRange: 0
     },
     count
   };
@@ -5455,6 +5469,7 @@ function deriveStats(ctx, dataset, damageProfile, fit, projectionReports) {
       weaponTracking: offense.weaponTracking,
       explosionVelocity: offense.explosionVelocity,
       explosionRadius: offense.explosionRadius,
+      missileRange: offense.missileRange,
       breakdown: offense.breakdown
     },
     capacitor: {

package/dist/node.cjs

@@ -260,6 +260,8 @@ var ATTR = {
   EXPLOSION_RADIUS: 654,
   DRF: 858,
   // damage reduction factor
+  EXPLOSION_DELAY: 281,
+  // charge attr — "Maximum Flight Time" (ms); range = maxVelocity × flightTime/1000
   // ---- Breacher Pods (DOT charges, e.g. SCARAB Breacher Pod M) ----
   DOT_DURATION: 5735,
   // ms
@@ -4245,11 +4247,15 @@ function collectDrains(ctx, dataset) {
       }
       continue;
     }
+    const seen = /* @__PURE__ */ new Set();
     for (const eid of m.effectIDs) {
       const effect = dataset.effects.get(eid);
       if (!effect) continue;
       const entry = drainEntryFromEffect(effect, m);
       if (!entry) continue;
+      const sig = `${entry.cycleMs}|${entry.capNeed}|${entry.clipSize}|${entry.reloadMs}|${entry.isInjector ? 1 : 0}|${entry.disableStagger ? 1 : 0}`;
+      if (seen.has(sig)) continue;
+      seen.add(sig);
       drains.push(entry);
       if (entry.capNeed > 0 && entry.cycleMs > 0) {
         totalGrossDrain += entry.capNeed / (entry.cycleMs / 1e3);
@@ -4679,10 +4685,14 @@ function readRangeInfo(item, effect, kind) {
   let explosionRadius = 0;
   let explosionVelocity = 0;
   let drf = 0;
+  let flightRange = 0;
   if (kind === "MISSILE" && item.charge) {
     explosionRadius = item.charge.getFinal(ATTR.EXPLOSION_RADIUS, 0);
     explosionVelocity = item.charge.getFinal(ATTR.EXPLOSION_VELOCITY, 0);
     drf = item.charge.getFinal(ATTR.DRF, 0);
+    const velocity = item.charge.getFinal(ATTR.MAX_VELOCITY, 0);
+    const flightMs = item.charge.getFinal(ATTR.EXPLOSION_DELAY, 0);
+    flightRange = velocity * flightMs / 1e3;
   }
   return {
     optimal,
@@ -4691,7 +4701,8 @@ function readRangeInfo(item, effect, kind) {
     burstRange,
     explosionRadius,
     explosionVelocity,
-    drf
+    drf,
+    flightRange
   };
 }
 
@@ -4772,6 +4783,7 @@ function computeOffense(ctx, dataset, fit) {
   const weaponTracking = turretContribs.length > 0 ? Math.min(...turretContribs.map((c) => c.range.tracking).filter((v) => v > 0)) : void 0;
   const explosionVelocity = missileContribs.length > 0 ? missileContribs[0].range.explosionVelocity : void 0;
   const explosionRadius = missileContribs.length > 0 ? missileContribs[0].range.explosionRadius : void 0;
+  const missileRange = missileContribs.length > 0 ? Math.max(...missileContribs.map((c) => c.range.flightRange).filter((v) => v > 0)) : void 0;
   return {
     weaponDps,
     weaponSustainedDps,
@@ -4785,6 +4797,7 @@ function computeOffense(ctx, dataset, fit) {
     weaponTracking,
     explosionVelocity,
     explosionRadius,
+    missileRange: missileRange != null && Number.isFinite(missileRange) ? missileRange : void 0,
     breakdown
   };
 }
@@ -4853,7 +4866,8 @@ function fighterContributionFor(fighter, count, _ctx, dataset) {
       burstRange: 0,
       explosionRadius: fighter.getFinal(2125, 0),
       explosionVelocity: fighter.getFinal(2126, 0),
-      drf: fighter.getFinal(2127, 0)
+      drf: fighter.getFinal(2127, 0),
+      flightRange: 0
     },
     count
   };
@@ -5485,6 +5499,7 @@ function deriveStats(ctx, dataset, damageProfile, fit, projectionReports) {
       weaponTracking: offense.weaponTracking,
       explosionVelocity: offense.explosionVelocity,
       explosionRadius: offense.explosionRadius,
+      missileRange: offense.missileRange,
       breakdown: offense.breakdown
     },
     capacitor: {

package/dist/node.js

@@ -236,6 +236,8 @@ var ATTR = {
   EXPLOSION_RADIUS: 654,
   DRF: 858,
   // damage reduction factor
+  EXPLOSION_DELAY: 281,
+  // charge attr — "Maximum Flight Time" (ms); range = maxVelocity × flightTime/1000
   // ---- Breacher Pods (DOT charges, e.g. SCARAB Breacher Pod M) ----
   DOT_DURATION: 5735,
   // ms
@@ -4221,11 +4223,15 @@ function collectDrains(ctx, dataset) {
       }
       continue;
     }
+    const seen = /* @__PURE__ */ new Set();
     for (const eid of m.effectIDs) {
       const effect = dataset.effects.get(eid);
       if (!effect) continue;
       const entry = drainEntryFromEffect(effect, m);
       if (!entry) continue;
+      const sig = `${entry.cycleMs}|${entry.capNeed}|${entry.clipSize}|${entry.reloadMs}|${entry.isInjector ? 1 : 0}|${entry.disableStagger ? 1 : 0}`;
+      if (seen.has(sig)) continue;
+      seen.add(sig);
       drains.push(entry);
       if (entry.capNeed > 0 && entry.cycleMs > 0) {
         totalGrossDrain += entry.capNeed / (entry.cycleMs / 1e3);
@@ -4655,10 +4661,14 @@ function readRangeInfo(item, effect, kind) {
   let explosionRadius = 0;
   let explosionVelocity = 0;
   let drf = 0;
+  let flightRange = 0;
   if (kind === "MISSILE" && item.charge) {
     explosionRadius = item.charge.getFinal(ATTR.EXPLOSION_RADIUS, 0);
     explosionVelocity = item.charge.getFinal(ATTR.EXPLOSION_VELOCITY, 0);
     drf = item.charge.getFinal(ATTR.DRF, 0);
+    const velocity = item.charge.getFinal(ATTR.MAX_VELOCITY, 0);
+    const flightMs = item.charge.getFinal(ATTR.EXPLOSION_DELAY, 0);
+    flightRange = velocity * flightMs / 1e3;
   }
   return {
     optimal,
@@ -4667,7 +4677,8 @@ function readRangeInfo(item, effect, kind) {
     burstRange,
     explosionRadius,
     explosionVelocity,
-    drf
+    drf,
+    flightRange
   };
 }
 
@@ -4748,6 +4759,7 @@ function computeOffense(ctx, dataset, fit) {
   const weaponTracking = turretContribs.length > 0 ? Math.min(...turretContribs.map((c) => c.range.tracking).filter((v) => v > 0)) : void 0;
   const explosionVelocity = missileContribs.length > 0 ? missileContribs[0].range.explosionVelocity : void 0;
   const explosionRadius = missileContribs.length > 0 ? missileContribs[0].range.explosionRadius : void 0;
+  const missileRange = missileContribs.length > 0 ? Math.max(...missileContribs.map((c) => c.range.flightRange).filter((v) => v > 0)) : void 0;
   return {
     weaponDps,
     weaponSustainedDps,
@@ -4761,6 +4773,7 @@ function computeOffense(ctx, dataset, fit) {
     weaponTracking,
     explosionVelocity,
     explosionRadius,
+    missileRange: missileRange != null && Number.isFinite(missileRange) ? missileRange : void 0,
     breakdown
   };
 }
@@ -4829,7 +4842,8 @@ function fighterContributionFor(fighter, count, _ctx, dataset) {
       burstRange: 0,
       explosionRadius: fighter.getFinal(2125, 0),
       explosionVelocity: fighter.getFinal(2126, 0),
-      drf: fighter.getFinal(2127, 0)
+      drf: fighter.getFinal(2127, 0),
+      flightRange: 0
     },
     count
   };
@@ -5461,6 +5475,7 @@ function deriveStats(ctx, dataset, damageProfile, fit, projectionReports) {
       weaponTracking: offense.weaponTracking,
       explosionVelocity: offense.explosionVelocity,
       explosionRadius: offense.explosionRadius,
+      missileRange: offense.missileRange,
       breakdown: offense.breakdown
     },
     capacitor: {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "eve-fit-engine",
-  "version": "0.1.2",
+  "version": "0.1.4",
   "description": "Pyfa-parity EVE Online ship & structure fitting calculation engine. Inject an SDE dataset + a fit, get the full derived stat block (offense, defense, capacitor, navigation, targeting, fitting, projected, structure).",
   "license": "GPL-3.0-or-later",
   "type": "module",