feat!: ship types, complete the models, and add production, flight and combat - #34

…d combat

Rounds out the library from "mine costs" to most of the maths a calculator
needs, and fixes the naming and data problems that had accumulated.

Models
- Buildings goes from 5 to 19 entries: storages, facilities and moon buildings.
- New Research model with the 16 technologies, Astrophysics rounding included.
- Every entry carries `names: { en, fr }` and `ogameId`, the id the game uses.
- `base` fields are named after what they are: `energyCost` (paid to build),
  `energyConsumption` (consumed once built) and `deuteriumConsumption` replace
  the `energy`/`consumption` pair that meant different things per building.
- `deutCost` held half the real fuel consumption on all 15 ships; corrected and
  renamed `fuelConsumption`. Ships also gained `drive` and `driveUpgrades`.
- models.test.js asserts the invariants every entry must hold, so a future
  entry that is incomplete or inconsistent fails CI.

Calculators
- The five mine and plant calculators no longer reimplement
  `base * factor ** (level - 1)`; they share cost.js and info.js, and all
  return the same seven fields. Behaviour is unchanged, verified against the
  previous expectations.
- They take the whole entry instead of its `base`, like everything else, and
  throw a message pointing at the fix when handed a `base`.
- New: getBuildingCost, getBuildTime, getStorage, getPlanetProduction,
  getProductionBonus, getResearchCost, getResearchTime.

Fleets
- getDistance, getShipSpeed, getFleetSpeed, getActiveDrive, getFlightTime,
  getFuelConsumption, getTrip.
- simulateCombat: six rounds, rapid fire, shield bounce and explosion odds,
  seedable so a battle can be replayed and averaged.

Types
- TypeScript declarations generated from the JSDoc into types/, wired through
  the exports map and built by prepack. Verified against a strict TS consumer.

Also
- The exports map only allowed the package root, so the subpath import the
  README documented never worked. Named subpaths added.
- README and CONTRIBUTING rewritten for the new surface, and MIGRATION.md added.
- infocompte reads its language from the report, accepts custom labels, throws
  readable errors, and returns numbers for mine levels.

BREAKING CHANGE: mine and plant calculators now take `Buildings[id]` rather
than `Buildings[id].base`, and return `energyCost`/`energyConsumption`/
`deuteriumConsumption` instead of `energy`/`consumption`.

BREAKING CHANGE: model fields renamed — `entry.name` to `entry.names.fr`,
`base.deutrium` to `base.deuterium`, `base.energy` to `base.energyConsumption`
or `base.energyCost`, `base.consumption` to `base.deuteriumConsumption`,
`fret` to `cargo`, `cost.deut` to `cost.deuterium`, and `deutCost` to
`fuelConsumption` with corrected values (they were half the in-game figure).

BREAKING CHANGE: parseInfoCompteData returns planet mine levels as numbers
instead of strings, and getDebris returns an extra `deuterium` key.

See MIGRATION.md for the full upgrade path.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>