eve-fit-engine 0.1.0

package/NOTICE

@@ -0,0 +1,31 @@
+@capsuleers/eve-fit-engine
+Copyright (C) 2026 Capsuleers.app
+
+This program is free software: you can redistribute it and/or modify it under
+the terms of the GNU General Public License as published by the Free Software
+Foundation, either version 3 of the License, or (at your option) any later
+version. See the LICENSE file for the full text.
+
+-------------------------------------------------------------------------------
+Derivative-work notice
+-------------------------------------------------------------------------------
+This engine is a derivative work of Pyfa (https://github.com/pyfa-org/Pyfa),
+the Python Fitting Assistant, which is licensed under the GNU GPL v3.0. The
+ship-fitting calculation semantics — effect handlers keyed by EVE dogma effect
+IDs, stacking-penalty groups, capacitor simulation, and the late-runtime
+resistance-adaptation pass — mirror Pyfa's `eos` calculation engine. As a
+derivative work, this package is distributed under the same GPL-3.0-or-later
+terms.
+
+Pyfa is Copyright (C) its respective authors. See the Pyfa repository for the
+list of contributors.
+
+-------------------------------------------------------------------------------
+EVE Online Static Data Export (SDE)
+-------------------------------------------------------------------------------
+This package contains NO EVE Online game data. It operates on a `FittingDataset`
+that the consumer supplies at runtime. EVE Online and the EVE logo are the
+registered trademarks of CCP hf. All EVE-related materials are property of CCP
+hf. SDE data is distributed by CCP under its own licence terms (the EVE Online
+Third-Party Developer License / SDE terms) and is NOT covered by this package's
+GPL licence.

package/README.md

@@ -0,0 +1,95 @@
+# eve-fit-engine
+
+A **Pyfa-parity** EVE Online ship & Upwell-structure fitting calculation engine,
+extracted from [capsuleers.app](https://capsuleers.app). Given a fit and an SDE
+dataset, it returns the full derived stat block you'd see in a fitting tool:
+offense (DPS / alpha / application), defense (EHP / resists / tank), capacitor
+(stability / sim), navigation, targeting, fitting (CPU / PG / calibration),
+projected effects, and structure fuel/service stats.
+
+> **Licence: GPL-3.0-or-later.** This engine is a derivative work of
+> [pyfa-org/Pyfa](https://github.com/pyfa-org/Pyfa) and is distributed under the
+> same terms. See [`NOTICE`](./NOTICE) and [`LICENSE`](./LICENSE). The complete
+> corresponding source is this repository.
+
+## Design
+
+- **Framework-free core.** The base entry has no `fetch`, no `fs`, no `window`,
+  no npm runtime deps. Runs in the browser, in Node, in a worker — anywhere.
+- **Two entries.** Base (`.`): inject your own `FittingDataset`. Node (`./node`):
+  batteries-included — bundles a snapshot of the EVE SDE (under CCP's licence, by
+  mere aggregation) + an fs loader, so it works out of the box on the server.
+- **Validated against Pyfa.** Stat parity is verified against Pyfa screenshots in
+  the upstream capsuleers.app fixture suite (`npm run test:pyfa`, 631 assertions
+  at All-V skills, zero tolerance overrides).
+
+## Install
+
+```bash
+npm install eve-fit-engine
+```
+
+## Usage — zero-config (Node, batteries-included)
+
+The `/node` entry ships with the EVE SDE bundle (`data/`, ~8 MB) and a built-in
+loader. Give it an EFT string, get full stats — nothing else to set up:
+
+```ts
+import { computeFromEft } from 'eve-fit-engine/node'
+
+const { fit, warnings, computed } = await computeFromEft(`
+[Rifter, My Fit]
+200mm AutoCannon II, Republic Fleet EMP S
+200mm AutoCannon II, Republic Fleet EMP S
+1MN Afterburner II
+Gyrostabilizer II
+`)
+
+console.log(computed.derived.offense.totalDps)              // 197.6
+console.log(computed.derived.defense.ehpTotalAgainstProfile)
+console.log(computed.derived.navigation.maxVelocity)
+```
+
+Defaults to All-V skills; pass `{ skillProfile, damageProfile, targetProfile, … }`
+as the second arg to override. `loadBundledDataset()` is also exported if you
+want the dataset directly.
+
+> The bundled SDE is CCP's, under CCP's EVE Online Developer License (see
+> [`data/SDE-LICENSE.md`](./data/SDE-LICENSE.md)) — included by mere aggregation,
+> NOT under this package's GPL.
+
+## Usage — bring-your-own dataset (browser / custom / always-fresh SDE)
+
+The base entry is environment-free (no `fs`, no bundled data). Inject a
+`FittingDataset` you build however you like:
+
+```ts
+import { computeFit, parseEft, type FittingDataset } from 'eve-fit-engine'
+
+const dataset: FittingDataset = await buildYourDataset()   // your SDE bundle
+const { fit } = parseEft(eftText, dataset)
+const computed = computeFit(fit, dataset, { skillProfile /* … */ })
+```
+
+This is what capsuleers.app uses server-side: it builds its own always-fresh
+bundle and injects it, so it never depends on the (snapshot) bundled data.
+
+## What's NOT in this package
+
+- 3D ship models, UI components — those live in the consuming application.
+- The bundled SDE is a **snapshot**; for always-fresh data, inject your own via
+  the base entry (see above).
+
+## Provenance / how parity is maintained
+
+The engine mirrors Pyfa's `eos` calculation model: effect handlers keyed by EVE
+dogma effect IDs, separate stacking-penalty pools per operation, a late-runtime
+resistance-adaptation pass, capacitor simulation, and spool-up handling. When CCP
+ships a new SDE, data-driven `modifierInfo` effects work automatically; new
+hardcoded mechanics in Pyfa's `effects.py` are tracked and ported, then re-checked
+against the parity suite before release.
+
+## Licence
+
+GPL-3.0-or-later. Copyright (C) 2026 Capsuleers.app. This is free software; see
+[`LICENSE`](./LICENSE) for details.

package/data/.build

@@ -0,0 +1 @@
+3368760

package/data/SDE-LICENSE.md

@@ -0,0 +1,17 @@
+# Bundled EVE Online Static Data Export (SDE)
+
+The JSON files in this directory are derived from CCP's EVE Online Static Data
+Export. **They are NOT covered by this package's GPL-3.0 licence.**
+
+EVE Online and the EVE logo are the registered trademarks of CCP hf. All rights
+reserved worldwide. All EVE-related materials are the property of CCP hf. This
+data is redistributed under CCP's **EVE Online Developer License Agreement**,
+which permits use of EVE Online data in third-party tools.
+
+It is included here purely by **mere aggregation** with the engine code (a
+convenience so the package works out of the box); it does not form part of, and
+is not relicensed by, the GPL-covered program.
+
+To run the engine against a fresher or custom SDE, build your own
+`FittingDataset` and use `computeFit` from the base entry instead of the bundled
+`eve-fit-engine/node` loader.

package/data/manifest.json

@@ -0,0 +1 @@
+{"version":"3e885b627373","builtAt":"2026-06-01T19:40:47.161Z","totalBytes":8404493,"files":{"attributes.json":{"bytes":248544,"entries":1258},"units.json":{"bytes":3458,"entries":60},"effects.json":{"bytes":1575723,"entries":3380},"meta-groups.json":{"bytes":1108,"entries":13},"categories.json":{"bytes":1192,"entries":33},"groups.json":{"bytes":63750,"entries":958},"market-groups.json":{"bytes":196588,"entries":2095},"clone-grades.json":{"bytes":18709,"entries":4},"dbuff-collections.json":{"bytes":74334,"entries":239},"dynamic-attributes.json":{"bytes":143140,"entries":413},"types/ships.json":{"bytes":899558,"entries":419},"types/modules.json":{"bytes":2559515,"entries":3978},"types/charges.json":{"bytes":599961,"entries":1017},"types/drones.json":{"bytes":191379,"entries":151},"types/fighters.json":{"bytes":132877,"entries":94},"types/implants.json":{"bytes":581650,"entries":1341},"types/subsystems.json":{"bytes":36255,"entries":48},"types/skills.json":{"bytes":202673,"entries":510},"types/system-effects.json":{"bytes":37911,"entries":114},"types/structures.json":{"bytes":31627,"entries":18},"types/structure-modules.json":{"bytes":246957,"entries":356},"types/mutaplasmids.json":{"bytes":557584,"entries":2839}}}