ogamejs 4.0.2 → 4.2.0

package/types/fleets/index.d.ts

@@ -2,7 +2,11 @@ import getDebris from './getDebris.js';
 import getDistance from './distance.js';
 import getShipSpeed, { getActiveDrive, getFleetSpeed } from './speed.js';
 import { getFlightTime, getFuelConsumption, getTrip } from './flight.js';
-import simulateCombat from './combat.js';
+import simulateCombat, { DEFAULT_REPAIR_FACTOR, DEFAULT_PLUNDER_RATIO } from './combat.js';
+import { getCombatStatistics, simulateCombats, DEFAULT_RUNS } from './combatStatistics.js';
+import { getWaveChance, getMoonbreakWaves, getMoonbreakChance, getMoonbreakLosses, MIN_MOON_SIZE, MAX_MOON_SIZE, WAVES_PER_ATTACKER } from './moonbreak.js';
+import { getExpeditionFindBase, getExpeditionMaxFind, getCargoCapacity, EXPEDITION_FIND_TIERS, EXPEDITION_TOP_TIER_BASE } from './expedition.js';
+import { getMoonLockShips, MOON_DEBRIS_THRESHOLD, MAX_MOON_CHANCE } from './moonLock.js';
 declare const Fleets: {
     getDebris: typeof getDebris;
     getDistance: typeof getDistance;
@@ -13,6 +17,17 @@ declare const Fleets: {
     getFuelConsumption: typeof getFuelConsumption;
     getTrip: typeof getTrip;
     simulateCombat: typeof simulateCombat;
+    simulateCombats: typeof simulateCombats;
+    getCombatStatistics: typeof getCombatStatistics;
+    getWaveChance: typeof getWaveChance;
+    getMoonbreakWaves: typeof getMoonbreakWaves;
+    getMoonbreakChance: typeof getMoonbreakChance;
+    getMoonbreakLosses: typeof getMoonbreakLosses;
+    getExpeditionFindBase: typeof getExpeditionFindBase;
+    getExpeditionMaxFind: typeof getExpeditionMaxFind;
+    getCargoCapacity: typeof getCargoCapacity;
+    getMoonLockShips: typeof getMoonLockShips;
 };
+export { MIN_MOON_SIZE, MAX_MOON_SIZE, WAVES_PER_ATTACKER, EXPEDITION_FIND_TIERS, EXPEDITION_TOP_TIER_BASE, MOON_DEBRIS_THRESHOLD, MAX_MOON_CHANCE, DEFAULT_REPAIR_FACTOR, DEFAULT_PLUNDER_RATIO, DEFAULT_RUNS, };
 export default Fleets;
 //# sourceMappingURL=index.d.ts.map

package/types/fleets/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/fleets/index.js"],"names":[],"mappings":"AAAA,OAAO,SAAS,MAAM,gBAAgB,CAAC;AACvC,OAAO,WAAW,MAAM,eAAe,CAAC;AACxC,OAAO,YAAY,EAAE,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AACzE,OAAO,EAAE,aAAa,EAAE,kBAAkB,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AACzE,OAAO,cAAc,MAAM,aAAa,CAAC;AAEzC,QAAA,MAAM,MAAM;;;;;;;;;;CAUX,CAAC;eAEa,MAAM"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/fleets/index.js"],"names":[],"mappings":"AAAA,OAAO,SAAS,MAAM,gBAAgB,CAAC;AACvC,OAAO,WAAW,MAAM,eAAe,CAAC;AACxC,OAAO,YAAY,EAAE,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AACzE,OAAO,EAAE,aAAa,EAAE,kBAAkB,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AACzE,OAAO,cAAc,EAAE,EAAE,qBAAqB,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAC3F,OAAO,EAAE,mBAAmB,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAC3F,OAAO,EACL,aAAa,EACb,iBAAiB,EACjB,kBAAkB,EAClB,kBAAkB,EAClB,aAAa,EACb,aAAa,EACb,kBAAkB,EACnB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,qBAAqB,EACrB,oBAAoB,EACpB,gBAAgB,EAChB,qBAAqB,EACrB,wBAAwB,EACzB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAEzF,QAAA,MAAM,MAAM;;;;;;;;;;;;;;;;;;;;CAoBX,CAAC;AAEF,OAAO,EACL,aAAa,EACb,aAAa,EACb,kBAAkB,EAClB,qBAAqB,EACrB,wBAAwB,EACxB,qBAAqB,EACrB,eAAe,EACf,qBAAqB,EACrB,qBAAqB,EACrB,YAAY,GACb,CAAC;eAEa,MAAM"}

package/types/fleets/moonLock.d.ts

@@ -0,0 +1,18 @@
+/** The debris that gives a moon its maximum chance to appear. */
+declare const MOON_DEBRIS_THRESHOLD = 2000000;
+/** The maximum moon chance, in %, reached at `MOON_DEBRIS_THRESHOLD`. */
+declare const MAX_MOON_CHANCE = 20;
+/**
+ *
+ * Return how many ships must be destroyed on a position to reach the maximum moon chance
+ *
+ * Only metal and crystal land in the debris field here, and the universe keeps
+ * `debrisFactor` of them.
+ * @param {import('../types.js').DestroyableEntry} ship An entry of models/destroyable.js
+ * @param {number} debrisFactor The universe debris factor, e.g. 0.3 for 30%
+ * @param {number} [threshold] The debris to reach, 2 000 000 by default
+ * @return {number} The number of ships
+ */
+declare function getMoonLockShips(ship: import('../types.js').DestroyableEntry, debrisFactor: number, threshold?: number): number;
+export { getMoonLockShips, MOON_DEBRIS_THRESHOLD, MAX_MOON_CHANCE };
+//# sourceMappingURL=moonLock.d.ts.map

package/types/fleets/moonLock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"moonLock.d.ts","sourceRoot":"","sources":["../../src/fleets/moonLock.js"],"names":[],"mappings":"AAAA,iEAAiE;AACjE,QAAA,MAAM,qBAAqB,UAAU,CAAC;AAEtC,yEAAyE;AACzE,QAAA,MAAM,eAAe,KAAK,CAAC;AAE3B;;;;;;;;;;GAUG;AACH,iBAAS,gBAAgB,CAAC,IAAI,EALnB,OAAO,aAAa,EAAE,gBAKH,EAAE,YAAY,EAJjC,MAIiC,EAAE,SAAS,AAHpD,CACA,EADQ,MAGoE,GAFnE,MAAM,CAajB;AAED,OAAO,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,eAAe,EAAE,CAAC"}

package/types/fleets/moonbreak.d.ts

@@ -0,0 +1,64 @@
+/** A moon size, in km, can only be in this range. */
+declare const MIN_MOON_SIZE = 3464;
+declare const MAX_MOON_SIZE = 8944;
+/** Each attacker spreads their Deathstars over this many waves. */
+declare const WAVES_PER_ATTACKER = 6;
+/**
+ *
+ * Return the chance that a single wave of Deathstars destroys the moon
+ *
+ * `(100 - sqrt(moonSize)) * sqrt(rip) / 100`, capped at 1
+ * @param {number} moonSize The moon diameter, in km
+ * @param {number} rip The number of Deathstars in the wave
+ * @return {number} The chance, between 0 and 1
+ */
+declare function getWaveChance(moonSize: number, rip: number): number;
+/**
+ *
+ * Return the waves one attacker sends, in firing order
+ *
+ * The Deathstars are spread over 6 waves: when the count is not a multiple of 6,
+ * the first waves carry one extra ship. Under 6 Deathstars, the last waves are
+ * empty, which neither threaten the moon nor lose a ship.
+ * @param {number} rip The attacker's Deathstars
+ * @return {number[]} The size of each of the 6 waves
+ */
+declare function getMoonbreakWaves(rip: number): number[];
+/**
+ *
+ * Return the chance that a coordinated attack destroys the moon
+ *
+ * The attackers fire one after the other and the moon is gone as soon as one
+ * wave succeeds, so the attack fails only when every wave fails.
+ * @param {number} moonSize The moon diameter, in km (3464 to 8944)
+ * @param {number[]} fleets The Deathstars of each attacker, in firing order
+ * @return {number} The chance, between 0 and 1
+ */
+declare function getMoonbreakChance(moonSize: number, fleets: number[]): number;
+/**
+ *
+ * Return the expected Deathstar losses of a coordinated attack
+ *
+ * Each Deathstar of a wave is destroyed with probability `sqrt(moonSize) / 200`,
+ * and a wave only costs ships if every wave before it failed. The variance sums
+ * the per-wave binomial variances (the waves are treated as independent), and
+ * the spread is summarised as a gaussian around the mean: 1σ / 2σ / 3σ for the
+ * 68 / 95 / 99 % bands, clamped between 0 and the whole fleet.
+ * @param {number} moonSize The moon diameter, in km (3464 to 8944)
+ * @param {number[]} fleets The Deathstars of each attacker, in firing order
+ * @return {{
+ *   mean: number, sigma: number,
+ *   bands: { confidence: number, min: number, max: number }[],
+ * }} The losses, unrounded
+ */
+declare function getMoonbreakLosses(moonSize: number, fleets: number[]): {
+    mean: number;
+    sigma: number;
+    bands: {
+        confidence: number;
+        min: number;
+        max: number;
+    }[];
+};
+export { getWaveChance, getMoonbreakWaves, getMoonbreakChance, getMoonbreakLosses, MIN_MOON_SIZE, MAX_MOON_SIZE, WAVES_PER_ATTACKER, };
+//# sourceMappingURL=moonbreak.d.ts.map

package/types/fleets/moonbreak.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"moonbreak.d.ts","sourceRoot":"","sources":["../../src/fleets/moonbreak.js"],"names":[],"mappings":"AAAA,qDAAqD;AACrD,QAAA,MAAM,aAAa,OAAO,CAAC;AAC3B,QAAA,MAAM,aAAa,OAAO,CAAC;AAE3B,mEAAmE;AACnE,QAAA,MAAM,kBAAkB,IAAI,CAAC;AAmB7B;;;;;;;;GAQG;AACH,iBAAS,aAAa,CAAC,QAAQ,EAJpB,MAIoB,EAAE,GAAG,EAHzB,MAGyB,GAFxB,MAAM,CAIjB;AAED;;;;;;;;;GASG;AACH,iBAAS,iBAAiB,CAAC,GAAG,EAHnB,MAGmB,GAFlB,MAAM,EAAE,CAOnB;AAED;;;;;;;;;GASG;AACH,iBAAS,kBAAkB,CAAC,QAAQ,EAJzB,MAIyB,EAAE,MAAM,EAHjC,MAAM,EAG2B,GAFhC,MAAM,CAWjB;AAED;;;;;;;;;;;;;;;GAeG;AACH,iBAAS,kBAAkB,CAAC,QAAQ,EAPzB,MAOyB,EAAE,MAAM,EANjC,MAAM,EAM2B,GALhC;IACP,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAC5B,KAAK,EAAE;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;CAC3D,CAiCH;AAED,OAAO,EACL,aAAa,EACb,iBAAiB,EACjB,kBAAkB,EAClB,kBAAkB,EAClB,aAAa,EACb,aAAa,EACb,kBAAkB,GACnB,CAAC"}

package/types/index.d.ts

@@ -31,6 +31,16 @@ declare const Ogame: {
         getFuelConsumption: typeof import("./fleets/flight.js").getFuelConsumption;
         getTrip: typeof import("./fleets/flight.js").getTrip;
         simulateCombat: typeof import("./fleets/combat.js").default;
+        simulateCombats: typeof import("./fleets/combatStatistics.js").simulateCombats;
+        getCombatStatistics: typeof import("./fleets/combatStatistics.js").getCombatStatistics;
+        getWaveChance: typeof import("./fleets/moonbreak.js").getWaveChance;
+        getMoonbreakWaves: typeof import("./fleets/moonbreak.js").getMoonbreakWaves;
+        getMoonbreakChance: typeof import("./fleets/moonbreak.js").getMoonbreakChance;
+        getMoonbreakLosses: typeof import("./fleets/moonbreak.js").getMoonbreakLosses;
+        getExpeditionFindBase: typeof import("./fleets/expedition.js").getExpeditionFindBase;
+        getExpeditionMaxFind: typeof import("./fleets/expedition.js").getExpeditionMaxFind;
+        getCargoCapacity: typeof import("./fleets/expedition.js").getCargoCapacity;
+        getMoonLockShips: typeof import("./fleets/moonLock.js").getMoonLockShips;
     };
     Research: {
         getResearchCost: typeof import("./cost.js").default;

package/types/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.js"],"names":[],"mappings":"AAOA,OAAO,EAAE,OAAO,EAAE,UAAU,EAAS,MAAM,WAAW,CAAC;AAEvD,QAAA,MAAM,KAAK;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAgBV,CAAC;eAEa,KAAK"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.js"],"names":[],"mappings":"AAOA,OAAO,EAAE,OAAO,EAAE,UAAU,EAAS,MAAM,WAAW,CAAC;AAEvD,QAAA,MAAM,KAAK;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAgBV,CAAC;eAEa,KAAK"}