wows-compute 1.0.0 → 1.1.0

package/README.md

@@ -1,110 +1,128 @@
-# wows-compute
-
-《战舰世界》对局数据的纯计算内核。无文件 IO、无网络、无运行时状态：输入是已经解析好的赛前名单或赛后回放结果，输出是可直接持久化或展示的 `MatchRecord`、评级与统计。
-
-已提供：`./match`、评级、时间、`./recent`、`./aggregate`、`./metrics`、`./strength`。
-
-## 安装
-
-```bash
-pnpm add wows-compute wows-number-api-sdk
-```
-
-ESM-only，Node.js 22.18+。
-
-## 入口
-
-| 入口 | 内容 |
-| --- | --- |
-| `wows-compute` | PR / PR*、等级、近期统计、聚合、游戏日与周界 |
-| `wows-compute/match` | `ArenaRoster`、`MatchRecord`、合并、赛前赛后关联、组队 |
-| `wows-compute/metrics` | 字段字典与派生指标 |
-| `wows-compute/strength` | 散点原料、参考线、角色配对 |
-
-## 快速上手
-
-```ts
-import { fromReplay, groupDivisions } from 'wows-compute/match'
-
-const record = fromReplay(parsedReplay)
-// record.arenaId、record.outcome、record.quality、record.participants
-
-const divisions = groupDivisions(record.participants)
-```
-
-`fromReplay` 接受 `wows-replay-parser` 的 `ParsedReplay` 结构，不依赖它的包，只有类型层面的结构兼容。
-
-### 平局
-
-事实层保留 `outcome: 'draw'`；统计层用 `statOutcome('draw')` 映射为 `loss`，即平局双输。`winnerTeamId` 为负数表示平局，`0` 是合法队伍。
-
-### 时间
-
-`battleTime` 优先取结果包的 `startDt`（UTC）。回放元数据的 `dateTime` 是录制者本机时间，跨区不可靠，只在没有结果包时作为回退。
-
-### 评级
-
-```ts
-import { accountPrEstimated, accountPrPooled, levelOf, shipPr } from 'wows-compute'
-
-const ship = shipPr(stats, expected)          // 精确，exact: true
-const account = accountPrEstimated(totals, expected) // PR*，exact: false
-const pooled = accountPrPooled(ships, expected, sample) // 精确加权，exact: true
-
-levelOf('pr', 1200) // { levelKey: 'average', floor: 1100, ... }
-```
-
-`exact: false` 是产品承诺：调用方必须把它显示为 `PR*`，不能与精确 PR 不加区分地混排。偏差方向通过 `bias` 输出；没有 `shipMix` 时是 `unknown`，不猜。
-
-PR 公式、预期值和分档阈值全部复用 `wows-number-api-sdk`，本包不复制常量。
-
-### 近期与聚合
-
-```ts
-import { aggregateTeam, recentMatches } from 'wows-compute'
-
-const recent = recentMatches(records, { subject: { kind: 'self' }, last: 20 }, expected)
-const team = aggregateTeam(records, teamId, {
-  weighting: 'equal',          // 监控页：每个席位一票
-  prAggregation: 'mean',
-  expected,
-})
-```
-
-- 近期只统计“已解析并入库”的对局，不扫描历史回放、不补缺口。
-- `winRate` 是百分数，例如 `54.3`。
-- 平局计入 `battles`，胜率为 `wins / battles`；`losses` 只计实际失败。
-- 记录总览用 `weighting: 'battles'` + `prAggregation: 'pooled'`；监控页用 `equal` + `mean`。
-- 分母为 0 返回 `null`；`coverage` 的 `resolved + hidden + bot + failed` 恒等于 `total`。
-
-### 指标字典
-
-```ts
-import { METRICS, deriveMetrics } from 'wows-compute/metrics'
-
-deriveMetrics(player.result.fields) // { damage, frags, potentialDamage, ... }
-```
-
-指标只做字段语义包装，不复制原始数据。新增字段必须能在回放字段映射中找到，测试会先失败。
-
-### 对局强度原料
-
-```ts
-import { buildPlayerPoints, pairByRole, referenceLines } from 'wows-compute/strength'
-
-const points = buildPlayerPoints(roster, ratings, catalog)
-const reference = referenceLines(points)
-const matchups = pairByRole(allyPoints, enemyPoints)
-```
-
-只输出散点原料、参考线和逐角色差值，不输出综合强度分或预测。
-
-## 约束
-
-- 不读写文件、不访问网络、不 import `node:*`。
-- 不扫描历史回放、不推断缺失对局、不做存储假设。
-- 只读已解析的数据；需要回放解析时使用 `wows-replay-parser`。
-
-## License
-
-MIT
+# wows-compute
+
+《战舰世界》对局数据的纯计算内核。无文件 IO、无网络、无运行时状态：输入是已经解析好的赛前名单或赛后回放结果，输出是可直接持久化或展示的 `MatchRecord`、评级与统计。
+
+已提供：`./match`、评级、时间、`./recent`、`./aggregate`、`./metrics`、`./strength`（含概览归纳）。
+
+## 安装
+
+```bash
+pnpm add wows-compute wows-number-api-sdk
+```
+
+ESM-only，Node.js 22.18+。
+
+## 入口
+
+| 入口 | 内容 |
+| --- | --- |
+| `wows-compute` | PR / PR*、等级、近期统计、聚合、概览归纳、游戏日与周界 |
+| `wows-compute/match` | `ArenaRoster`、`MatchRecord`、合并、赛前赛后关联、组队 |
+| `wows-compute/metrics` | 字段字典与派生指标 |
+| `wows-compute/strength` | 散点原料、概览归纳、参考线、角色配对 |
+
+## 快速上手
+
+```ts
+import { fromReplay, groupDivisions } from 'wows-compute/match'
+
+const record = fromReplay(parsedReplay)
+// record.arenaId、record.outcome、record.quality、record.participants
+
+const divisions = groupDivisions(record.participants)
+```
+
+`fromReplay` 接受 `wows-replay-parser` 的 `ParsedReplay` 结构，不依赖它的包，只有类型层面的结构兼容。
+
+### 平局
+
+事实层保留 `outcome: 'draw'`；统计层用 `statOutcome('draw')` 映射为 `loss`，即平局双输。`winnerTeamId` 为负数表示平局，`0` 是合法队伍。
+
+### 时间
+
+`battleTime` 优先取结果包的 `startDt`（UTC）。回放元数据的 `dateTime` 是录制者本机时间，跨区不可靠，只在没有结果包时作为回退。
+
+### 评级
+
+```ts
+import { accountPrEstimated, accountPrPooled, levelOf, shipPr } from 'wows-compute'
+
+const ship = shipPr(stats, expected)          // 精确，exact: true
+const account = accountPrEstimated(totals, expected) // PR*，exact: false
+const pooled = accountPrPooled(ships, expected, sample) // 精确加权，exact: true
+
+levelOf('pr', 1200) // { levelKey: 'average', floor: 1100, ... }
+```
+
+`exact: false` 是产品承诺：调用方必须把它显示为 `PR*`，不能与精确 PR 不加区分地混排。偏差方向通过 `bias` 输出；没有 `shipMix` 时是 `unknown`，不猜。
+
+PR 公式、预期值和分档阈值全部复用 `wows-number-api-sdk`，本包不复制常量。
+
+### 近期与聚合
+
+```ts
+import { aggregateTeam, recentMatches } from 'wows-compute'
+
+const recent = recentMatches(records, { subject: { kind: 'self' }, last: 20 }, expected)
+const team = aggregateTeam(records, teamId, {
+  weighting: 'equal',          // 监控页：每个席位一票
+  prAggregation: 'mean',
+  expected,
+})
+```
+
+- 近期只统计“已解析并入库”的对局，不扫描历史回放、不补缺口。
+- `winRate` 是百分数，例如 `54.3`。
+- 平局计入 `battles`，胜率为 `wins / battles`；`losses` 只计实际失败。
+- 记录总览用 `weighting: 'battles'` + `prAggregation: 'pooled'`；监控页用 `equal` + `mean`。
+- 分母为 0 返回 `null`；`coverage` 的 `resolved + hidden + bot + failed` 恒等于 `total`。
+
+### 指标字典
+
+```ts
+import { METRICS, deriveMetrics } from 'wows-compute/metrics'
+
+deriveMetrics(player.result.fields) // { damage, frags, potentialDamage, ... }
+```
+
+指标只做字段语义包装，不复制原始数据。新增字段必须能在回放字段映射中找到，测试会先失败。
+
+### 对局强度原料
+
+```ts
+import { buildPlayerPoints, pairByRole, referenceLines } from 'wows-compute/strength'
+
+const points = buildPlayerPoints(roster, ratings, catalog)
+const reference = referenceLines(points)
+const matchups = pairByRole(allyPoints, enemyPoints)
+```
+
+只输出散点原料、参考线和逐角色差值，不输出综合强度分或预测。
+
+### 队伍概览
+
+`summarizePlayers` / `summarizeRoster` 对已经标准化的 `PlayerPoint` 做加权归纳，输入不是对局记录：
+
+```ts
+import { buildPlayerPoints, summarizeRoster } from 'wows-compute/strength'
+
+const points = buildPlayerPoints(roster, ratings, catalog)
+const { ally, enemy, unassigned } = summarizeRoster(points)
+// ally.players、ally.battles、ally.winRate / avgDamage / avgFrags / pr、ally.coverage
+```
+
+- 与 `aggregate*` 的分工：`aggregate*` 从逐局 `MatchRecord` 推导统计；overview 只归纳已算好的值，赛前赛后可复用。
+- 默认 `weighting: 'equal'`（一人一票），可改为 `'battles'` 按生涯场次加权。
+- 每项均值只使用非 null 值，`0` 是合法值，分母为 0 返回 `null`。
+- `coverage` 的单位是席位：`total` 含 Bot，`players` 只算真人，且 `resolved + hidden + bot + failed === total`。
+- 概览 PR 是对账号 PR 的均值，`prExact` 恒为 `false`，展示时必须标 `PR*`。
+
+## 约束
+
+- 不读写文件、不访问网络、不 import `node:*`。
+- 不扫描历史回放、不推断缺失对局、不做存储假设。
+- 只读已解析的数据；需要回放解析时使用 `wows-replay-parser`。
+
+## License
+
+MIT

package/dist/index-CkKx_Wtz.d.mts

@@ -0,0 +1,286 @@
+import { c as MatchRecord, i as ArenaRoster, o as MatchGroup, p as Relation } from "./types-DwmuyfXs.mjs";
+import { ExpectedValuesDocument, ShipBattleStats, SingleBattleInput } from "wows-number-api-sdk";
+//#region src/rating/index.d.ts
+interface SampleDescriptor {
+  kind: 'ingested' | 'lifetime' | 'match';
+  matches: number;
+  /** ISO timestamps; present for date windows. */
+  from?: string;
+  to?: string;
+  /** When querying another player: matches shared with the local player. */
+  sharedWith?: number;
+  players?: number;
+}
+interface EstimateBias {
+  direction: 'underestimate' | 'overestimate' | 'mixed' | 'unknown';
+  reason: 'ship-mix' | 'insufficient-data';
+  /** Relative baseline difference: pooled baseline / global average - 1. */
+  delta?: {
+    damage?: number;
+    frags?: number;
+    wins?: number;
+  };
+}
+interface RatedValue {
+  value: number;
+  basis: 'ship' | 'account';
+  exact: boolean;
+  sample: SampleDescriptor;
+  /** Expected-values version, taken from `expected.time`. */
+  baselineVersion: string;
+  /** Only present when `exact === false`. */
+  bias?: EstimateBias;
+}
+interface AccountTotals {
+  battles: number;
+  damage: number;
+  frags: number;
+  wins: number;
+}
+interface ShipMixEntry {
+  shipId: number | string;
+  battles: number;
+}
+interface AccountPrOptions {
+  shipMix?: readonly ShipMixEntry[];
+}
+/** Personal Rating for one ship, using that ship's own expected values. */
+declare function shipPr(stats: ShipBattleStats, expected: ExpectedValuesDocument, sample?: SampleDescriptor): RatedValue | null;
+/** Personal Rating for a single battle. */
+declare function battlePr(battle: SingleBattleInput, expected: ExpectedValuesDocument, sample?: SampleDescriptor): RatedValue | null;
+/**
+ * Fast account PR*: account totals against the unweighted average of all
+ * expected values.
+ *
+ * This is an estimate, not a different formula: the account is treated as one
+ * synthetic ship. `exact: false` is a product promise — UI must mark it `PR*`.
+ */
+declare function accountPrEstimated(account: AccountTotals, expected: ExpectedValuesDocument, options?: AccountPrOptions): RatedValue | null;
+/**
+ * Exact weighted account PR: pools per-ship totals and per-ship baselines.
+ *
+ * Ships without expected values are skipped by `calculatePR`, not counted
+ * as zero.
+ */
+declare function accountPrPooled(ships: readonly ShipBattleStats[], expected: ExpectedValuesDocument, sample: SampleDescriptor): RatedValue | null;
+//#endregion
+//#region src/aggregate/index.d.ts
+type Weighting = 'equal' | 'battles';
+type PrAggregation = 'mean' | 'pooled';
+interface Coverage {
+  total: number;
+  resolved: number;
+  hidden: number;
+  bot: number;
+  failed: number;
+}
+interface AggregatedValue {
+  value: number | null;
+  sample: SampleDescriptor;
+  coverage: Coverage;
+}
+interface AggregateOptions {
+  weighting: Weighting;
+  prAggregation: PrAggregation;
+  expected?: ExpectedValuesDocument;
+  matchGroups?: readonly MatchGroup[];
+  from?: number;
+  to?: number;
+}
+interface PlayerAggregate {
+  accountId: number;
+  name: string | null;
+  battles: number;
+  wins: number;
+  losses: number;
+  draws: number;
+  damage: number;
+  frags: number;
+  winRate: AggregatedValue;
+  avgDamage: AggregatedValue;
+  avgFrags: AggregatedValue;
+  pr: AggregatedValue;
+}
+interface TeamAggregate {
+  teamId: number | null;
+  players: number;
+  coverage: Coverage;
+  values: {
+    winRate: AggregatedValue;
+    avgDamage: AggregatedValue;
+    avgFrags: AggregatedValue;
+    pr: AggregatedValue;
+  };
+}
+interface ShipAggregate {
+  shipId: number;
+  battles: number;
+  wins: number;
+  losses: number;
+  draws: number;
+  damage: number;
+  frags: number;
+  winRate: AggregatedValue;
+  avgDamage: AggregatedValue;
+  avgFrags: AggregatedValue;
+  pr: AggregatedValue;
+}
+interface DailyPoint {
+  day: string;
+  matches: number;
+  battles: number;
+  wins: number;
+  losses: number;
+  draws: number;
+  winRate: number | null;
+  avgDamage: number | null;
+  avgFrags: number | null;
+  pr: AggregatedValue;
+}
+interface DailyOptions {
+  timeZone: string;
+  boundaryHour?: number;
+  expected?: ExpectedValuesDocument;
+  matchGroups?: readonly MatchGroup[];
+  from?: number;
+  to?: number;
+}
+/** Per-player aggregates over the selected records. Ordered by battles, then account id. */
+declare function aggregatePlayers(records: readonly MatchRecord[], options: AggregateOptions): PlayerAggregate[];
+/** One team's aggregate; coverage only counts that team's participants. */
+declare function aggregateTeam(records: readonly MatchRecord[], teamId: number | null, options: AggregateOptions): TeamAggregate;
+/** Per-ship aggregates over the selected records. Ordered by battles, then ship id. */
+declare function aggregateShips(records: readonly MatchRecord[], options: AggregateOptions): ShipAggregate[];
+/** Self performance per game day, ordered oldest first. */
+declare function dailySeries(records: readonly MatchRecord[], options: DailyOptions): DailyPoint[];
+//#endregion
+//#region src/strength/index.d.ts
+type ShipRole = 'submarine' | 'aircraft-carrier' | 'destroyer' | 'battleship' | 'cruiser-functional' | 'cruiser-firepower' | 'cruiser' | 'unknown';
+/** Display / analysis order; not a composite score. */
+declare const ROLE_ORDER: readonly ShipRole[];
+interface ShipCatalogLike {
+  role?: (shipId: number) => ShipRole | null;
+  tier?: (shipId: number) => number | null;
+}
+interface PlayerRatingSnapshot {
+  pr?: RatedValue | null;
+  /** Lifetime win rate in percent, e.g. `54.3`. */
+  winRate?: number | null;
+  battles?: number | null;
+  /** Lifetime average damage; `null` when unavailable. */
+  avgDamage?: number | null;
+  /** Lifetime average frags; `null` when unavailable. */
+  avgFrags?: number | null;
+  /** Platform-flagged hidden profile, distinct from "no data". */
+  hidden?: boolean;
+}
+type PlayerRatingValue = RatedValue | PlayerRatingSnapshot;
+type PlayerRatings = ReadonlyMap<number, PlayerRatingValue>;
+interface PlayerPoint {
+  accountId: number | null;
+  name: string | null;
+  /** `null` for pre-battle rosters; relations are known, team ids are not. */
+  teamId: number | null;
+  shipId: number | null;
+  shipRole: ShipRole;
+  tier: number | null;
+  divisionId: number | null;
+  /** Percentage, e.g. `54.3`. */
+  winRate: number | null;
+  pr: number | null;
+  prExact: boolean;
+  battles: number | null;
+  isBot: boolean;
+  /** Roster relation; used to group points into sides. */
+  relation: Relation;
+  avgDamage: number | null;
+  avgFrags: number | null;
+  hidden: boolean;
+}
+interface ReferenceLines {
+  winRateMedian: number | null;
+  prMedian: number | null;
+}
+type Quadrant = 'q1' | 'q2' | 'q3' | 'q4' | 'unknown';
+interface RoleWeightProfile {
+  weights?: Partial<Record<ShipRole, number>>;
+}
+interface RoleMatchup {
+  role: ShipRole;
+  allyCount: number;
+  enemyCount: number;
+  allyMedianPr: number | null;
+  enemyMedianPr: number | null;
+  allyMedianWinRate: number | null;
+  enemyMedianWinRate: number | null;
+  /** Ally median minus enemy median; `null` when either side lacks values. */
+  prDiff: number | null;
+  winRateDiff: number | null;
+  weight: number | null;
+  sample: {
+    ally: number;
+    enemy: number;
+  };
+  coverage: Coverage;
+}
+/** Maps a roster to scatter-plot points. Bots and hidden players stay in the list. */
+declare function buildPlayerPoints(roster: ArenaRoster, ratings: PlayerRatings, catalog?: ShipCatalogLike): PlayerPoint[];
+declare function median(values: readonly number[]): number | null;
+declare function referenceLines(points: readonly PlayerPoint[]): ReferenceLines;
+/**
+ * Quadrants relative to the reference lines.
+ *
+ * q1 high win rate + high PR, q2 low win rate + high PR,
+ * q3 low + low, q4 high win rate + low PR.
+ */
+declare function quadrantOf(point: PlayerPoint, reference: ReferenceLines): Quadrant;
+/**
+ * Per-role ally/enemy comparison.
+ *
+ * Returns differences and samples only; no composite score and no prediction.
+ */
+declare function pairByRole(ally: readonly PlayerPoint[], enemy: readonly PlayerPoint[], profile?: RoleWeightProfile): RoleMatchup[];
+interface SummaryOptions {
+  /**
+   * `equal` (default): one player, one vote.
+   * `battles`: weight by the player's lifetime battles.
+   */
+  weighting?: Weighting;
+}
+interface PlayerSummary {
+  /** All slots on the side, including bots. */
+  total: number;
+  /** Non-bot slots. */
+  players: number;
+  /** Sum of non-null lifetime battles for non-bot players. */
+  battles: number;
+  /** Counts slots, not participant-match samples. */
+  coverage: Coverage;
+  /** Percentage, e.g. `54.3`. */
+  winRate: number | null;
+  avgDamage: number | null;
+  avgFrags: number | null;
+  pr: number | null;
+  /**
+   * Always false: a mean of account PR values is not an official team PR.
+   * UI must mark it `PR*`.
+   */
+  prExact: false;
+}
+interface RosterSummary {
+  ally: PlayerSummary;
+  enemy: PlayerSummary;
+  /** Slots that cannot be assigned to a side (`relation === 'unknown'`). */
+  unassigned: number;
+}
+/**
+ * Reduces normalized player points into one side's overview.
+ *
+ * Averages only over non-null values; `0` is a valid value. Empty input
+ * returns an all-zero summary rather than throwing.
+ */
+declare function summarizePlayers(points: readonly PlayerPoint[], options?: SummaryOptions): PlayerSummary;
+/** Groups points by `relation` and summarizes both sides. */
+declare function summarizeRoster(points: readonly PlayerPoint[], options?: SummaryOptions): RosterSummary;
+//#endregion
+export { TeamAggregate as A, SampleDescriptor as B, AggregatedValue as C, PlayerAggregate as D, DailyPoint as E, dailySeries as F, shipPr as G, accountPrEstimated as H, AccountPrOptions as I, AccountTotals as L, aggregatePlayers as M, aggregateShips as N, PrAggregation as O, aggregateTeam as P, EstimateBias as R, AggregateOptions as S, DailyOptions as T, accountPrPooled as U, ShipMixEntry as V, battlePr as W, pairByRole as _, PlayerSummary as a, summarizePlayers as b, ReferenceLines as c, RosterSummary as d, ShipCatalogLike as f, median as g, buildPlayerPoints as h, PlayerRatings as i, Weighting as j, ShipAggregate as k, RoleMatchup as l, SummaryOptions as m, PlayerRatingSnapshot as n, Quadrant as o, ShipRole as p, PlayerRatingValue as r, ROLE_ORDER as s, PlayerPoint as t, RoleWeightProfile as u, quadrantOf as v, Coverage as w, summarizeRoster as x, referenceLines as y, RatedValue as z };

package/dist/index.d.mts

@@ -1,4 +1,4 @@
-import { C as battlePr, S as accountPrPooled, _ as EstimateBias, a as DailyPoint, b as ShipMixEntry, c as ShipAggregate, d as aggregatePlayers, f as aggregateShips, g as AccountTotals, h as AccountPrOptions, i as DailyOptions, l as TeamAggregate, m as dailySeries, n as AggregatedValue, o as PlayerAggregate, p as aggregateTeam, r as Coverage, s as PrAggregation, t as AggregateOptions, u as Weighting, v as RatedValue, w as shipPr, x as accountPrEstimated, y as SampleDescriptor } from "./index-DoUlnTgG.mjs";
+import { A as TeamAggregate, B as SampleDescriptor, C as AggregatedValue, D as PlayerAggregate, E as DailyPoint, F as dailySeries, G as shipPr, H as accountPrEstimated, I as AccountPrOptions, L as AccountTotals, M as aggregatePlayers, N as aggregateShips, O as PrAggregation, P as aggregateTeam, R as EstimateBias, S as AggregateOptions, T as DailyOptions, U as accountPrPooled, V as ShipMixEntry, W as battlePr, a as PlayerSummary, b as summarizePlayers, d as RosterSummary, j as Weighting, k as ShipAggregate, m as SummaryOptions, w as Coverage, x as summarizeRoster, z as RatedValue } from "./index-CkKx_Wtz.mjs";
 import { c as MatchRecord, o as MatchGroup } from "./types-DwmuyfXs.mjs";
 import { ExpectedValuesDocument, ExpectedValuesDocument as ExpectedValuesDocument$1, PR_BANDS, PR_CATEGORY_LABELS, PersonalRatingCategory, PersonalRatingCategory as PersonalRatingCategory$1, ShipBattleStats, ShipExpectedValues, SingleBattleInput, WIN_RATE_BANDS, prCategory, winRateCategory } from "wows-number-api-sdk";
 //#region src/levels/index.d.ts
@@ -79,4 +79,4 @@ export declare function weekBoundary(timestamp: number, timeZone: string, bounda
 /** Inclusive range check; omitted bounds are open. */
 export declare function inRange(timestamp: number, from?: number, to?: number): boolean;
 //#endregion
-export { AccountPrOptions, AccountTotals, AggregateOptions, AggregatedValue, Coverage, DailyOptions, DailyPoint, EstimateBias, type ExpectedValuesDocument, PR_BANDS, PR_CATEGORY_LABELS, type PersonalRatingCategory, PlayerAggregate, PrAggregation, RatedValue, SampleDescriptor, ShipAggregate, type ShipBattleStats, type ShipExpectedValues, ShipMixEntry, type SingleBattleInput, TeamAggregate, WIN_RATE_BANDS, Weighting, accountPrEstimated, accountPrPooled, aggregatePlayers, aggregateShips, aggregateTeam, battlePr, dailySeries, prCategory, shipPr, winRateCategory };
+export { AccountPrOptions, AccountTotals, AggregateOptions, AggregatedValue, Coverage, DailyOptions, DailyPoint, EstimateBias, type ExpectedValuesDocument, PR_BANDS, PR_CATEGORY_LABELS, type PersonalRatingCategory, PlayerAggregate, type PlayerSummary, PrAggregation, RatedValue, type RosterSummary, SampleDescriptor, ShipAggregate, type ShipBattleStats, type ShipExpectedValues, ShipMixEntry, type SingleBattleInput, type SummaryOptions, TeamAggregate, WIN_RATE_BANDS, Weighting, accountPrEstimated, accountPrPooled, aggregatePlayers, aggregateShips, aggregateTeam, battlePr, dailySeries, prCategory, shipPr, summarizePlayers, summarizeRoster, winRateCategory };

package/dist/index.mjs

@@ -1,4 +1,5 @@
 import { d as gameDay, f as inRange, l as outcomeOf, m as weekBoundary, p as parseBattleTime, u as statOutcome } from "./match-J2T9QiGg.mjs";
+import { c as summarizeRoster, s as summarizePlayers } from "./strength-CBihFxZD.mjs";
 import { PR_BANDS, PR_BANDS as PR_BANDS$1, PR_CATEGORY_LABELS, WIN_RATE_BANDS, WIN_RATE_BANDS as WIN_RATE_BANDS$1, calculateBattlePR, calculatePR, prCategory, prCategory as prCategory$1, shipExpectedValues, winRateCategory, winRateCategory as winRateCategory$1 } from "wows-number-api-sdk";
 //#region src/rating/index.ts
 const ACCOUNT_SHIP_ID = "__account__";
@@ -666,4 +667,4 @@ function recentMatches(records, query, expected) {
 	};
 }
 //#endregion
-export { PR_BANDS, PR_CATEGORY_LABELS, WIN_RATE_BANDS, accountPrEstimated, accountPrPooled, aggregatePlayers, aggregateShips, aggregateTeam, battlePr, dailySeries, gameDay, inRange, levelOf, parseBattleTime, prCategory, recentMatches, shipPr, weekBoundary, winRateCategory };
+export { PR_BANDS, PR_CATEGORY_LABELS, WIN_RATE_BANDS, accountPrEstimated, accountPrPooled, aggregatePlayers, aggregateShips, aggregateTeam, battlePr, dailySeries, gameDay, inRange, levelOf, parseBattleTime, prCategory, recentMatches, shipPr, summarizePlayers, summarizeRoster, weekBoundary, winRateCategory };

package/dist/strength-CBihFxZD.mjs

@@ -0,0 +1,243 @@
+//#region src/strength/index.ts
+/** Display / analysis order; not a composite score. */
+const ROLE_ORDER = [
+	"submarine",
+	"aircraft-carrier",
+	"destroyer",
+	"battleship",
+	"cruiser-functional",
+	"cruiser-firepower",
+	"cruiser",
+	"unknown"
+];
+function isRatedValue(value) {
+	return "value" in value && "basis" in value && "exact" in value;
+}
+function normalize(value) {
+	if (value === void 0) return {
+		pr: null,
+		winRate: null,
+		battles: null,
+		avgDamage: null,
+		avgFrags: null,
+		hidden: false
+	};
+	if (isRatedValue(value)) return {
+		pr: value,
+		winRate: null,
+		battles: value.sample.matches,
+		avgDamage: null,
+		avgFrags: null,
+		hidden: false
+	};
+	return {
+		pr: value.pr ?? null,
+		winRate: value.winRate ?? null,
+		battles: value.battles ?? value.pr?.sample.matches ?? null,
+		avgDamage: value.avgDamage ?? null,
+		avgFrags: value.avgFrags ?? null,
+		hidden: value.hidden ?? false
+	};
+}
+/** Maps a roster to scatter-plot points. Bots and hidden players stay in the list. */
+function buildPlayerPoints(roster, ratings, catalog) {
+	return roster.participants.map((participant) => {
+		const rating = participant.accountId === null ? normalize(void 0) : normalize(ratings.get(participant.accountId));
+		return {
+			accountId: participant.accountId,
+			name: participant.name,
+			teamId: null,
+			shipId: participant.shipId,
+			shipRole: participant.shipId === null ? "unknown" : catalog?.role?.(participant.shipId) ?? "unknown",
+			tier: participant.shipId === null ? null : catalog?.tier?.(participant.shipId) ?? null,
+			divisionId: null,
+			winRate: rating.winRate,
+			pr: rating.pr?.value ?? null,
+			prExact: rating.pr?.exact ?? false,
+			battles: rating.battles,
+			isBot: participant.isBot,
+			relation: participant.relation,
+			avgDamage: rating.avgDamage,
+			avgFrags: rating.avgFrags,
+			hidden: rating.hidden
+		};
+	});
+}
+function median(values) {
+	if (values.length === 0) return null;
+	const sorted = [...values].sort((a, b) => a - b);
+	const middle = Math.floor(sorted.length / 2);
+	if (sorted.length % 2 === 1) return sorted[middle];
+	return (sorted[middle - 1] + sorted[middle]) / 2;
+}
+function referenceLines(points) {
+	return {
+		winRateMedian: median(points.map((point) => point.winRate).filter((value) => value !== null)),
+		prMedian: median(points.map((point) => point.pr).filter((value) => value !== null))
+	};
+}
+/**
+* Quadrants relative to the reference lines.
+*
+* q1 high win rate + high PR, q2 low win rate + high PR,
+* q3 low + low, q4 high win rate + low PR.
+*/
+function quadrantOf(point, reference) {
+	if (point.winRate === null || point.pr === null || reference.winRateMedian === null || reference.prMedian === null) return "unknown";
+	const highWinRate = point.winRate >= reference.winRateMedian;
+	const highPr = point.pr >= reference.prMedian;
+	if (highWinRate) return highPr ? "q1" : "q4";
+	return highPr ? "q2" : "q3";
+}
+function roleCoverage(ally, enemy) {
+	const coverage = {
+		total: 0,
+		resolved: 0,
+		hidden: 0,
+		bot: 0,
+		failed: 0
+	};
+	for (const point of [...ally, ...enemy]) {
+		coverage.total += 1;
+		if (point.isBot) {
+			coverage.bot += 1;
+			continue;
+		}
+		if (point.accountId === null) {
+			coverage.hidden += 1;
+			continue;
+		}
+		if (point.pr === null) {
+			coverage.failed += 1;
+			continue;
+		}
+		coverage.resolved += 1;
+	}
+	return coverage;
+}
+function diff(left, right) {
+	return left === null || right === null ? null : left - right;
+}
+/**
+* Per-role ally/enemy comparison.
+*
+* Returns differences and samples only; no composite score and no prediction.
+*/
+function pairByRole(ally, enemy, profile) {
+	const allyByRole = /* @__PURE__ */ new Map();
+	const enemyByRole = /* @__PURE__ */ new Map();
+	for (const point of ally) {
+		const list = allyByRole.get(point.shipRole) ?? [];
+		list.push(point);
+		allyByRole.set(point.shipRole, list);
+	}
+	for (const point of enemy) {
+		const list = enemyByRole.get(point.shipRole) ?? [];
+		list.push(point);
+		enemyByRole.set(point.shipRole, list);
+	}
+	return ROLE_ORDER.filter((role) => allyByRole.has(role) || enemyByRole.has(role)).map((role) => {
+		const allies = allyByRole.get(role) ?? [];
+		const enemies = enemyByRole.get(role) ?? [];
+		const allyMedianPr = median(allies.map((point) => point.pr).filter((value) => value !== null));
+		const enemyMedianPr = median(enemies.map((point) => point.pr).filter((value) => value !== null));
+		const allyMedianWinRate = median(allies.map((point) => point.winRate).filter((value) => value !== null));
+		const enemyMedianWinRate = median(enemies.map((point) => point.winRate).filter((value) => value !== null));
+		return {
+			role,
+			allyCount: allies.length,
+			enemyCount: enemies.length,
+			allyMedianPr,
+			enemyMedianPr,
+			allyMedianWinRate,
+			enemyMedianWinRate,
+			prDiff: diff(allyMedianPr, enemyMedianPr),
+			winRateDiff: diff(allyMedianWinRate, enemyMedianWinRate),
+			weight: profile?.weights?.[role] ?? null,
+			sample: {
+				ally: allies.length,
+				enemy: enemies.length
+			},
+			coverage: roleCoverage(allies, enemies)
+		};
+	});
+}
+function summaryCoverage(points) {
+	const coverage = {
+		total: 0,
+		resolved: 0,
+		hidden: 0,
+		bot: 0,
+		failed: 0
+	};
+	for (const point of points) {
+		coverage.total += 1;
+		if (point.isBot) {
+			coverage.bot += 1;
+			continue;
+		}
+		if (point.hidden || point.accountId === null) {
+			coverage.hidden += 1;
+			continue;
+		}
+		if (point.winRate === null && point.avgDamage === null && point.avgFrags === null && point.pr === null) {
+			coverage.failed += 1;
+			continue;
+		}
+		coverage.resolved += 1;
+	}
+	return coverage;
+}
+function meanOf(points, metric, weighting) {
+	let total = 0;
+	let weightSum = 0;
+	for (const point of points) {
+		const value = point[metric];
+		if (value === null) continue;
+		const weight = weighting === "battles" ? point.battles ?? 0 : 1;
+		if (weight <= 0) continue;
+		total += value * weight;
+		weightSum += weight;
+	}
+	return weightSum === 0 ? null : total / weightSum;
+}
+/**
+* Reduces normalized player points into one side's overview.
+*
+* Averages only over non-null values; `0` is a valid value. Empty input
+* returns an all-zero summary rather than throwing.
+*/
+function summarizePlayers(points, options = {}) {
+	const weighting = options.weighting ?? "equal";
+	const coverage = summaryCoverage(points);
+	const members = points.filter((point) => !point.isBot);
+	let battles = 0;
+	for (const point of members) if (point.battles !== null) battles += point.battles;
+	return {
+		total: coverage.total,
+		players: coverage.total - coverage.bot,
+		battles,
+		coverage,
+		winRate: meanOf(members, "winRate", weighting),
+		avgDamage: meanOf(members, "avgDamage", weighting),
+		avgFrags: meanOf(members, "avgFrags", weighting),
+		pr: meanOf(members, "pr", weighting),
+		prExact: false
+	};
+}
+/** Groups points by `relation` and summarizes both sides. */
+function summarizeRoster(points, options = {}) {
+	const ally = [];
+	const enemy = [];
+	let unassigned = 0;
+	for (const point of points) if (point.relation === "self" || point.relation === "ally") ally.push(point);
+	else if (point.relation === "enemy") enemy.push(point);
+	else unassigned += 1;
+	return {
+		ally: summarizePlayers(ally, options),
+		enemy: summarizePlayers(enemy, options),
+		unassigned
+	};
+}
+//#endregion
+export { quadrantOf as a, summarizeRoster as c, pairByRole as i, buildPlayerPoints as n, referenceLines as o, median as r, summarizePlayers as s, ROLE_ORDER as t };

package/dist/strength.d.mts

@@ -1,80 +1,3 @@
-import { r as Coverage, v as RatedValue } from "./index-DoUlnTgG.mjs";
-import { i as ArenaRoster } from "./types-DwmuyfXs.mjs";
+import { _ as pairByRole, a as PlayerSummary, b as summarizePlayers, c as ReferenceLines, d as RosterSummary, f as ShipCatalogLike, g as median, h as buildPlayerPoints, i as PlayerRatings, l as RoleMatchup, m as SummaryOptions, n as PlayerRatingSnapshot, o as Quadrant, p as ShipRole, r as PlayerRatingValue, s as ROLE_ORDER, t as PlayerPoint, u as RoleWeightProfile, v as quadrantOf, x as summarizeRoster, y as referenceLines } from "./index-CkKx_Wtz.mjs";
 import { o as groupDivisions } from "./index-_QacyXDj.mjs";
-//#region src/strength/index.d.ts
-export type ShipRole = 'submarine' | 'aircraft-carrier' | 'destroyer' | 'battleship' | 'cruiser-functional' | 'cruiser-firepower' | 'cruiser' | 'unknown';
-/** Display / analysis order; not a composite score. */
-export declare const ROLE_ORDER: readonly ShipRole[];
-export interface ShipCatalogLike {
-  role?: (shipId: number) => ShipRole | null;
-  tier?: (shipId: number) => number | null;
-}
-export interface PlayerRatingSnapshot {
-  pr?: RatedValue | null;
-  /** Lifetime win rate in percent, e.g. `54.3`. */
-  winRate?: number | null;
-  battles?: number | null;
-}
-export type PlayerRatingValue = RatedValue | PlayerRatingSnapshot;
-export type PlayerRatings = ReadonlyMap<number, PlayerRatingValue>;
-export interface PlayerPoint {
-  accountId: number | null;
-  name: string | null;
-  /** `null` for pre-battle rosters; relations are known, team ids are not. */
-  teamId: number | null;
-  shipId: number | null;
-  shipRole: ShipRole;
-  tier: number | null;
-  divisionId: number | null;
-  /** Percentage, e.g. `54.3`. */
-  winRate: number | null;
-  pr: number | null;
-  prExact: boolean;
-  battles: number | null;
-  isBot: boolean;
-}
-export interface ReferenceLines {
-  winRateMedian: number | null;
-  prMedian: number | null;
-}
-export type Quadrant = 'q1' | 'q2' | 'q3' | 'q4' | 'unknown';
-export interface RoleWeightProfile {
-  weights?: Partial<Record<ShipRole, number>>;
-}
-export interface RoleMatchup {
-  role: ShipRole;
-  allyCount: number;
-  enemyCount: number;
-  allyMedianPr: number | null;
-  enemyMedianPr: number | null;
-  allyMedianWinRate: number | null;
-  enemyMedianWinRate: number | null;
-  /** Ally median minus enemy median; `null` when either side lacks values. */
-  prDiff: number | null;
-  winRateDiff: number | null;
-  weight: number | null;
-  sample: {
-    ally: number;
-    enemy: number;
-  };
-  coverage: Coverage;
-}
-/** Maps a roster to scatter-plot points. Bots and hidden players stay in the list. */
-export declare function buildPlayerPoints(roster: ArenaRoster, ratings: PlayerRatings, catalog?: ShipCatalogLike): PlayerPoint[];
-export declare function median(values: readonly number[]): number | null;
-export declare function referenceLines(points: readonly PlayerPoint[]): ReferenceLines;
-/**
- * Quadrants relative to the reference lines.
- *
- * q1 high win rate + high PR, q2 low win rate + high PR,
- * q3 low + low, q4 high win rate + low PR.
- */
-export declare function quadrantOf(point: PlayerPoint, reference: ReferenceLines): Quadrant;
-/**
- * Per-role ally/enemy comparison.
- *
- * Returns differences and samples only; no composite score and no prediction.
- */
-export declare function pairByRole(ally: readonly PlayerPoint[], enemy: readonly PlayerPoint[], profile?: RoleWeightProfile): RoleMatchup[];
-//#endregion
-export { groupDivisions };
+export { PlayerPoint, PlayerRatingSnapshot, PlayerRatingValue, PlayerRatings, PlayerSummary, Quadrant, ROLE_ORDER, ReferenceLines, RoleMatchup, RoleWeightProfile, RosterSummary, ShipCatalogLike, ShipRole, SummaryOptions, buildPlayerPoints, groupDivisions, median, pairByRole, quadrantOf, referenceLines, summarizePlayers, summarizeRoster };

package/dist/strength.mjs

@@ -1,154 +1,3 @@
 import { i as groupDivisions } from "./match-J2T9QiGg.mjs";
-//#region src/strength/index.ts
-/** Display / analysis order; not a composite score. */
-const ROLE_ORDER = [
-	"submarine",
-	"aircraft-carrier",
-	"destroyer",
-	"battleship",
-	"cruiser-functional",
-	"cruiser-firepower",
-	"cruiser",
-	"unknown"
-];
-function isRatedValue(value) {
-	return "value" in value && "basis" in value && "exact" in value;
-}
-function normalize(value) {
-	if (value === void 0) return {
-		pr: null,
-		winRate: null,
-		battles: null
-	};
-	if (isRatedValue(value)) return {
-		pr: value,
-		winRate: null,
-		battles: value.sample.matches
-	};
-	return {
-		pr: value.pr ?? null,
-		winRate: value.winRate ?? null,
-		battles: value.battles ?? value.pr?.sample.matches ?? null
-	};
-}
-/** Maps a roster to scatter-plot points. Bots and hidden players stay in the list. */
-function buildPlayerPoints(roster, ratings, catalog) {
-	return roster.participants.map((participant) => {
-		const rating = participant.accountId === null ? normalize(void 0) : normalize(ratings.get(participant.accountId));
-		return {
-			accountId: participant.accountId,
-			name: participant.name,
-			teamId: null,
-			shipId: participant.shipId,
-			shipRole: participant.shipId === null ? "unknown" : catalog?.role?.(participant.shipId) ?? "unknown",
-			tier: participant.shipId === null ? null : catalog?.tier?.(participant.shipId) ?? null,
-			divisionId: null,
-			winRate: rating.winRate,
-			pr: rating.pr?.value ?? null,
-			prExact: rating.pr?.exact ?? false,
-			battles: rating.battles,
-			isBot: participant.isBot
-		};
-	});
-}
-function median(values) {
-	if (values.length === 0) return null;
-	const sorted = [...values].sort((a, b) => a - b);
-	const middle = Math.floor(sorted.length / 2);
-	if (sorted.length % 2 === 1) return sorted[middle];
-	return (sorted[middle - 1] + sorted[middle]) / 2;
-}
-function referenceLines(points) {
-	return {
-		winRateMedian: median(points.map((point) => point.winRate).filter((value) => value !== null)),
-		prMedian: median(points.map((point) => point.pr).filter((value) => value !== null))
-	};
-}
-/**
-* Quadrants relative to the reference lines.
-*
-* q1 high win rate + high PR, q2 low win rate + high PR,
-* q3 low + low, q4 high win rate + low PR.
-*/
-function quadrantOf(point, reference) {
-	if (point.winRate === null || point.pr === null || reference.winRateMedian === null || reference.prMedian === null) return "unknown";
-	const highWinRate = point.winRate >= reference.winRateMedian;
-	const highPr = point.pr >= reference.prMedian;
-	if (highWinRate) return highPr ? "q1" : "q4";
-	return highPr ? "q2" : "q3";
-}
-function roleCoverage(ally, enemy) {
-	const coverage = {
-		total: 0,
-		resolved: 0,
-		hidden: 0,
-		bot: 0,
-		failed: 0
-	};
-	for (const point of [...ally, ...enemy]) {
-		coverage.total += 1;
-		if (point.isBot) {
-			coverage.bot += 1;
-			continue;
-		}
-		if (point.accountId === null) {
-			coverage.hidden += 1;
-			continue;
-		}
-		if (point.pr === null) {
-			coverage.failed += 1;
-			continue;
-		}
-		coverage.resolved += 1;
-	}
-	return coverage;
-}
-function diff(left, right) {
-	return left === null || right === null ? null : left - right;
-}
-/**
-* Per-role ally/enemy comparison.
-*
-* Returns differences and samples only; no composite score and no prediction.
-*/
-function pairByRole(ally, enemy, profile) {
-	const allyByRole = /* @__PURE__ */ new Map();
-	const enemyByRole = /* @__PURE__ */ new Map();
-	for (const point of ally) {
-		const list = allyByRole.get(point.shipRole) ?? [];
-		list.push(point);
-		allyByRole.set(point.shipRole, list);
-	}
-	for (const point of enemy) {
-		const list = enemyByRole.get(point.shipRole) ?? [];
-		list.push(point);
-		enemyByRole.set(point.shipRole, list);
-	}
-	return ROLE_ORDER.filter((role) => allyByRole.has(role) || enemyByRole.has(role)).map((role) => {
-		const allies = allyByRole.get(role) ?? [];
-		const enemies = enemyByRole.get(role) ?? [];
-		const allyMedianPr = median(allies.map((point) => point.pr).filter((value) => value !== null));
-		const enemyMedianPr = median(enemies.map((point) => point.pr).filter((value) => value !== null));
-		const allyMedianWinRate = median(allies.map((point) => point.winRate).filter((value) => value !== null));
-		const enemyMedianWinRate = median(enemies.map((point) => point.winRate).filter((value) => value !== null));
-		return {
-			role,
-			allyCount: allies.length,
-			enemyCount: enemies.length,
-			allyMedianPr,
-			enemyMedianPr,
-			allyMedianWinRate,
-			enemyMedianWinRate,
-			prDiff: diff(allyMedianPr, enemyMedianPr),
-			winRateDiff: diff(allyMedianWinRate, enemyMedianWinRate),
-			weight: profile?.weights?.[role] ?? null,
-			sample: {
-				ally: allies.length,
-				enemy: enemies.length
-			},
-			coverage: roleCoverage(allies, enemies)
-		};
-	});
-}
-//#endregion
-export { ROLE_ORDER, buildPlayerPoints, groupDivisions, median, pairByRole, quadrantOf, referenceLines };
+import { a as quadrantOf, c as summarizeRoster, i as pairByRole, n as buildPlayerPoints, o as referenceLines, r as median, s as summarizePlayers, t as ROLE_ORDER } from "./strength-CBihFxZD.mjs";
+export { ROLE_ORDER, buildPlayerPoints, groupDivisions, median, pairByRole, quadrantOf, referenceLines, summarizePlayers, summarizeRoster };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "wows-compute",
-  "version": "1.0.0",
+  "version": "1.1.0",
   "description": "Pure TypeScript computation kernels for World of Warships match records, ratings and aggregates.",
   "type": "module",
   "license": "MIT",

package/dist/index-DoUlnTgG.d.mts

@@ -1,157 +0,0 @@
-import { c as MatchRecord, o as MatchGroup } from "./types-DwmuyfXs.mjs";
-import { ExpectedValuesDocument, ShipBattleStats, SingleBattleInput } from "wows-number-api-sdk";
-//#region src/rating/index.d.ts
-interface SampleDescriptor {
-  kind: 'ingested' | 'lifetime' | 'match';
-  matches: number;
-  /** ISO timestamps; present for date windows. */
-  from?: string;
-  to?: string;
-  /** When querying another player: matches shared with the local player. */
-  sharedWith?: number;
-  players?: number;
-}
-interface EstimateBias {
-  direction: 'underestimate' | 'overestimate' | 'mixed' | 'unknown';
-  reason: 'ship-mix' | 'insufficient-data';
-  /** Relative baseline difference: pooled baseline / global average - 1. */
-  delta?: {
-    damage?: number;
-    frags?: number;
-    wins?: number;
-  };
-}
-interface RatedValue {
-  value: number;
-  basis: 'ship' | 'account';
-  exact: boolean;
-  sample: SampleDescriptor;
-  /** Expected-values version, taken from `expected.time`. */
-  baselineVersion: string;
-  /** Only present when `exact === false`. */
-  bias?: EstimateBias;
-}
-interface AccountTotals {
-  battles: number;
-  damage: number;
-  frags: number;
-  wins: number;
-}
-interface ShipMixEntry {
-  shipId: number | string;
-  battles: number;
-}
-interface AccountPrOptions {
-  shipMix?: readonly ShipMixEntry[];
-}
-/** Personal Rating for one ship, using that ship's own expected values. */
-declare function shipPr(stats: ShipBattleStats, expected: ExpectedValuesDocument, sample?: SampleDescriptor): RatedValue | null;
-/** Personal Rating for a single battle. */
-declare function battlePr(battle: SingleBattleInput, expected: ExpectedValuesDocument, sample?: SampleDescriptor): RatedValue | null;
-/**
- * Fast account PR*: account totals against the unweighted average of all
- * expected values.
- *
- * This is an estimate, not a different formula: the account is treated as one
- * synthetic ship. `exact: false` is a product promise — UI must mark it `PR*`.
- */
-declare function accountPrEstimated(account: AccountTotals, expected: ExpectedValuesDocument, options?: AccountPrOptions): RatedValue | null;
-/**
- * Exact weighted account PR: pools per-ship totals and per-ship baselines.
- *
- * Ships without expected values are skipped by `calculatePR`, not counted
- * as zero.
- */
-declare function accountPrPooled(ships: readonly ShipBattleStats[], expected: ExpectedValuesDocument, sample: SampleDescriptor): RatedValue | null;
-//#endregion
-//#region src/aggregate/index.d.ts
-type Weighting = 'equal' | 'battles';
-type PrAggregation = 'mean' | 'pooled';
-interface Coverage {
-  total: number;
-  resolved: number;
-  hidden: number;
-  bot: number;
-  failed: number;
-}
-interface AggregatedValue {
-  value: number | null;
-  sample: SampleDescriptor;
-  coverage: Coverage;
-}
-interface AggregateOptions {
-  weighting: Weighting;
-  prAggregation: PrAggregation;
-  expected?: ExpectedValuesDocument;
-  matchGroups?: readonly MatchGroup[];
-  from?: number;
-  to?: number;
-}
-interface PlayerAggregate {
-  accountId: number;
-  name: string | null;
-  battles: number;
-  wins: number;
-  losses: number;
-  draws: number;
-  damage: number;
-  frags: number;
-  winRate: AggregatedValue;
-  avgDamage: AggregatedValue;
-  avgFrags: AggregatedValue;
-  pr: AggregatedValue;
-}
-interface TeamAggregate {
-  teamId: number | null;
-  players: number;
-  coverage: Coverage;
-  values: {
-    winRate: AggregatedValue;
-    avgDamage: AggregatedValue;
-    avgFrags: AggregatedValue;
-    pr: AggregatedValue;
-  };
-}
-interface ShipAggregate {
-  shipId: number;
-  battles: number;
-  wins: number;
-  losses: number;
-  draws: number;
-  damage: number;
-  frags: number;
-  winRate: AggregatedValue;
-  avgDamage: AggregatedValue;
-  avgFrags: AggregatedValue;
-  pr: AggregatedValue;
-}
-interface DailyPoint {
-  day: string;
-  matches: number;
-  battles: number;
-  wins: number;
-  losses: number;
-  draws: number;
-  winRate: number | null;
-  avgDamage: number | null;
-  avgFrags: number | null;
-  pr: AggregatedValue;
-}
-interface DailyOptions {
-  timeZone: string;
-  boundaryHour?: number;
-  expected?: ExpectedValuesDocument;
-  matchGroups?: readonly MatchGroup[];
-  from?: number;
-  to?: number;
-}
-/** Per-player aggregates over the selected records. Ordered by battles, then account id. */
-declare function aggregatePlayers(records: readonly MatchRecord[], options: AggregateOptions): PlayerAggregate[];
-/** One team's aggregate; coverage only counts that team's participants. */
-declare function aggregateTeam(records: readonly MatchRecord[], teamId: number | null, options: AggregateOptions): TeamAggregate;
-/** Per-ship aggregates over the selected records. Ordered by battles, then ship id. */
-declare function aggregateShips(records: readonly MatchRecord[], options: AggregateOptions): ShipAggregate[];
-/** Self performance per game day, ordered oldest first. */
-declare function dailySeries(records: readonly MatchRecord[], options: DailyOptions): DailyPoint[];
-//#endregion
-export { battlePr as C, accountPrPooled as S, EstimateBias as _, DailyPoint as a, ShipMixEntry as b, ShipAggregate as c, aggregatePlayers as d, aggregateShips as f, AccountTotals as g, AccountPrOptions as h, DailyOptions as i, TeamAggregate as l, dailySeries as m, AggregatedValue as n, PlayerAggregate as o, aggregateTeam as p, Coverage as r, PrAggregation as s, AggregateOptions as t, Weighting as u, RatedValue as v, shipPr as w, accountPrEstimated as x, SampleDescriptor as y };