@rine-kit/pubg-intelligence 0.0.0-stage → 0.1.1

package/dist/src/field.js

@@ -0,0 +1,298 @@
+import { parseTelemetryPayload } from '@rine-kit/pubg-domain';
+import { normalizeWeaponName, wilsonInterval } from './analytics.js';
+export const FIELD_SCHEMA_VERSION = 1;
+/** Engagement distance bands in metres; the last band is open ended. */
+export const DISTANCE_BANDS = [
+    { id: 'close', label: '近距 <25m', maxMeters: 25 },
+    { id: 'mid', label: '中近 25–75m', maxMeters: 75 },
+    { id: 'far', label: '中远 75–150m', maxMeters: 150 },
+    { id: 'long', label: '远距 ≥150m', maxMeters: Infinity },
+];
+export const DISTANCE_MIN_DAMAGE = 600;
+export const DISTANCE_GAP_POINTS = 0.1;
+export const ZONE_MAX_PHASE = 9;
+export const ZONE_MIN_SAMPLES = 150;
+export const ZONE_BIN_EDGES = [0.5, 0.85, 1];
+export const CONTEST_RADIUS_METERS = 500;
+export const CONTEST_MIN_MATCHES = 8;
+const BAND_COUNT = DISTANCE_BANDS.length;
+export function distanceBandOf(meters) {
+    const index = DISTANCE_BANDS.findIndex((band) => meters < band.maxMeters);
+    return index < 0 ? BAND_COUNT - 1 : index;
+}
+function obj(value) {
+    return value && typeof value === 'object' && !Array.isArray(value)
+        ? value
+        : {};
+}
+function num(value) {
+    return typeof value === 'number' && Number.isFinite(value) ? value : null;
+}
+function point(value) {
+    const location = obj(value);
+    const x = num(location.x);
+    const y = num(location.y);
+    if (x === null || y === null)
+        return null;
+    return { x, y, z: num(location.z) ?? 0 };
+}
+function inMatchPhase(event) {
+    const value = num(obj(event.common).isGame);
+    return value !== null && value >= 1 ? value : null;
+}
+function emptyPhase() {
+    return { samples: 0, blueSamples: 0, bins: [0, 0, 0, 0], blueDamage: 0 };
+}
+/**
+ * One pass over a raw telemetry payload for the tracked squad: damage by engagement distance, time spent
+ * outside the safe zone, blue-zone damage and how crowded the landing spot was.
+ */
+export function analyzeFieldTelemetry(payload, trackedIds) {
+    const stats = {
+        distance: {
+            dealt: new Array(BAND_COUNT).fill(0),
+            dealtHead: new Array(BAND_COUNT).fill(0),
+            taken: new Array(BAND_COUNT).fill(0),
+            takenHead: new Array(BAND_COUNT).fill(0),
+            weapons: {},
+        },
+        zone: { phases: {}, blueDamage: 0, damageTaken: 0 },
+        landing: { contestedTeams: null, nearestEnemyMeters: null, region: null },
+    };
+    const phase = (value) => {
+        const key = Math.min(ZONE_MAX_PHASE, Math.max(1, Math.floor(value)));
+        return (stats.zone.phases[key] ??= emptyPhase());
+    };
+    let safety = null;
+    const landings = [];
+    const landedAt = new Map();
+    const regions = new Map();
+    const regionSeen = new Set();
+    for (const raw of parseTelemetryPayload(payload)) {
+        const event = obj(raw);
+        const type = event._T;
+        const time = typeof event._D === 'string' ? Date.parse(event._D) : NaN;
+        if (type === 'LogGameStatePeriodic') {
+            if (inMatchPhase(event) === null)
+                continue;
+            const state = obj(event.gameState);
+            const center = point(state.safetyZonePosition);
+            const radius = num(state.safetyZoneRadius);
+            if (center && radius !== null && radius > 0)
+                safety = { center, radius };
+            continue;
+        }
+        if (type === 'LogParachuteLanding') {
+            const character = obj(event.character);
+            const accountId = typeof character.accountId === 'string' ? character.accountId : null;
+            const location = point(character.location);
+            if (!accountId || !location)
+                continue;
+            landings.push({
+                accountId,
+                teamId: String(character.teamId ?? ''),
+                x: location.x / 100,
+                y: location.y / 100,
+                time,
+            });
+            if (trackedIds.has(accountId))
+                landedAt.set(accountId, time);
+            continue;
+        }
+        if (type === 'LogPlayerPosition') {
+            const character = obj(event.character);
+            const accountId = typeof character.accountId === 'string' ? character.accountId : null;
+            if (!accountId || !trackedIds.has(accountId))
+                continue;
+            const landed = landedAt.get(accountId);
+            if (landed !== undefined && !regionSeen.has(accountId) && time >= landed) {
+                const zones = Array.isArray(character.zone) ? character.zone : [];
+                const name = typeof zones[0] === 'string' ? zones[0] : null;
+                if (name) {
+                    regionSeen.add(accountId);
+                    regions.set(name, (regions.get(name) ?? 0) + 1);
+                }
+            }
+            const phaseValue = inMatchPhase(event);
+            const location = point(character.location);
+            if (phaseValue === null || !location)
+                continue;
+            const entry = phase(phaseValue);
+            entry.samples += 1;
+            if (character.isInBlueZone === true)
+                entry.blueSamples += 1;
+            if (safety) {
+                const ratio = Math.hypot(location.x - safety.center.x, location.y - safety.center.y) / safety.radius;
+                const bin = ratio < ZONE_BIN_EDGES[0]
+                    ? 0
+                    : ratio < ZONE_BIN_EDGES[1]
+                        ? 1
+                        : ratio <= ZONE_BIN_EDGES[2]
+                            ? 2
+                            : 3;
+                entry.bins[bin] += 1;
+            }
+            continue;
+        }
+        if (type === 'LogPlayerTakeDamage') {
+            const phaseValue = inMatchPhase(event);
+            if (phaseValue === null)
+                continue;
+            const damage = num(event.damage);
+            if (damage === null || damage <= 0)
+                continue;
+            const attacker = obj(event.attacker);
+            const victim = obj(event.victim);
+            const victimId = typeof victim.accountId === 'string' ? victim.accountId : null;
+            const attackerId = typeof attacker.accountId === 'string' ? attacker.accountId : null;
+            const victimTracked = victimId !== null && trackedIds.has(victimId);
+            const attackerTracked = attackerId !== null && trackedIds.has(attackerId);
+            const category = typeof event.damageTypeCategory === 'string' ? event.damageTypeCategory : '';
+            if (victimTracked) {
+                stats.zone.damageTaken += damage;
+                if (category === 'Damage_BlueZone' || category === 'Damage_BlueZoneGrenade') {
+                    stats.zone.blueDamage += damage;
+                    phase(phaseValue).blueDamage += damage;
+                }
+            }
+            if (category !== 'Damage_Gun' || victimTracked === attackerTracked)
+                continue;
+            const from = point(attacker.location);
+            const to = point(victim.location);
+            if (!from || !to)
+                continue;
+            if (String(attacker.teamId ?? '') === String(victim.teamId ?? ''))
+                continue;
+            const meters = Math.hypot(from.x - to.x, from.y - to.y, from.z - to.z) / 100;
+            const band = distanceBandOf(meters);
+            const head = event.damageReason === 'HeadShot';
+            if (attackerTracked) {
+                stats.distance.dealt[band] += damage;
+                if (head)
+                    stats.distance.dealtHead[band] += damage;
+                const weapon = typeof event.damageCauserName === 'string'
+                    ? normalizeWeaponName(event.damageCauserName)
+                    : null;
+                if (weapon)
+                    (stats.distance.weapons[weapon] ??= new Array(BAND_COUNT).fill(0))[band] +=
+                        damage;
+            }
+            else {
+                stats.distance.taken[band] += damage;
+                if (head)
+                    stats.distance.takenHead[band] += damage;
+            }
+        }
+    }
+    const mine = landings.filter((landing) => trackedIds.has(landing.accountId));
+    if (mine.length) {
+        const cx = mine.reduce((sum, landing) => sum + landing.x, 0) / mine.length;
+        const cy = mine.reduce((sum, landing) => sum + landing.y, 0) / mine.length;
+        const ourTeams = new Set(mine.map((landing) => landing.teamId));
+        const nearestByTeam = new Map();
+        for (const landing of landings) {
+            if (ourTeams.has(landing.teamId) || trackedIds.has(landing.accountId))
+                continue;
+            const distance = Math.hypot(landing.x - cx, landing.y - cy);
+            nearestByTeam.set(landing.teamId, Math.min(nearestByTeam.get(landing.teamId) ?? Infinity, distance));
+        }
+        const nearest = [...nearestByTeam.values()];
+        stats.landing.contestedTeams = nearest.filter((distance) => distance <= CONTEST_RADIUS_METERS).length;
+        stats.landing.nearestEnemyMeters = nearest.length ? Math.min(...nearest) : null;
+        stats.landing.region =
+            [...regions.entries()].sort((left, right) => right[1] - left[1] || left[0].localeCompare(right[0]))[0]?.[0] ?? null;
+    }
+    return stats;
+}
+export function summarizeDistance(items) {
+    const sumBand = (pick) => Array.from({ length: BAND_COUNT }, (_, band) => items.reduce((total, item) => total + (pick(item)[band] ?? 0), 0));
+    const dealt = sumBand((item) => item.distance.dealt);
+    const taken = sumBand((item) => item.distance.taken);
+    const head = sumBand((item) => item.distance.dealtHead);
+    const totalDealt = dealt.reduce((sum, value) => sum + value, 0);
+    const totalTaken = taken.reduce((sum, value) => sum + value, 0);
+    const weapons = new Map();
+    for (const item of items) {
+        for (const [weapon, bands] of Object.entries(item.distance.weapons)) {
+            const current = weapons.get(weapon) ?? new Array(BAND_COUNT).fill(0);
+            bands.forEach((value, index) => {
+                current[index] += value;
+            });
+            weapons.set(weapon, current);
+        }
+    }
+    const longShare = (values, total) => total > 0 ? (values[2] + values[3]) / total : null;
+    const dealtLong = longShare(dealt, totalDealt);
+    const takenLong = longShare(taken, totalTaken);
+    return {
+        matches: items.length,
+        totalDealt,
+        totalTaken,
+        bands: DISTANCE_BANDS.map((band, index) => ({
+            id: band.id,
+            label: band.label,
+            dealt: dealt[index],
+            taken: taken[index],
+            dealtShare: totalDealt > 0 ? dealt[index] / totalDealt : null,
+            takenShare: totalTaken > 0 ? taken[index] / totalTaken : null,
+            headshotShare: dealt[index] > 0 ? head[index] / dealt[index] : null,
+        })),
+        weapons: [...weapons.entries()]
+            .map(([weapon, bands]) => {
+            const total = bands.reduce((sum, value) => sum + value, 0);
+            const main = bands.indexOf(Math.max(...bands));
+            return {
+                weapon,
+                damage: total,
+                shares: bands.map((value) => (total > 0 ? value / total : 0)),
+                mainBand: DISTANCE_BANDS[main].label,
+            };
+        })
+            .filter((entry) => entry.damage >= 200)
+            .sort((left, right) => right.damage - left.damage || left.weapon.localeCompare(right.weapon))
+            .slice(0, 8),
+        longRangeGap: dealtLong !== null &&
+            takenLong !== null &&
+            totalDealt >= DISTANCE_MIN_DAMAGE &&
+            totalTaken >= DISTANCE_MIN_DAMAGE
+            ? takenLong - dealtLong
+            : null,
+    };
+}
+export function summarizeZone(items) {
+    const phases = new Map();
+    for (const item of items) {
+        for (const [key, value] of Object.entries(item.zone.phases)) {
+            const current = phases.get(Number(key)) ?? emptyPhase();
+            current.samples += value.samples;
+            current.blueSamples += value.blueSamples;
+            value.bins.forEach((count, index) => {
+                current.bins[index] += count;
+            });
+            current.blueDamage += value.blueDamage;
+            phases.set(Number(key), current);
+        }
+    }
+    const blue = items.reduce((sum, item) => sum + item.zone.blueDamage, 0);
+    const taken = items.reduce((sum, item) => sum + item.zone.damageTaken, 0);
+    return {
+        matches: items.length,
+        blueDamagePerMatch: items.length ? blue / items.length : null,
+        blueDamageShare: taken > 0 ? blue / taken : null,
+        phases: [...phases.entries()]
+            .sort(([left], [right]) => left - right)
+            .map(([phaseNumber, value]) => {
+            const binTotal = value.bins.reduce((sum, count) => sum + count, 0);
+            return {
+                phase: phaseNumber,
+                samples: value.samples,
+                outsideRate: wilsonInterval(value.blueSamples, value.samples),
+                binShares: binTotal > 0
+                    ? value.bins.map((count) => count / binTotal)
+                    : null,
+                blueDamage: value.blueDamage,
+            };
+        }),
+    };
+}
+//# sourceMappingURL=field.js.map

package/dist/src/field.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"field.js","sourceRoot":"","sources":["../../src/field.ts"],"names":[],"mappings":"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"}

package/dist/src/fights.d.ts

@@ -0,0 +1,89 @@
+import { type DifferenceEstimate, type RateEstimate } from './analytics.js';
+import { type BattleReconstructionResult } from './battle.js';
+import { type DeathStage } from './combat-quality.js';
+export declare const FIGHTS_SCHEMA_VERSION: 1;
+export declare const FIGHT_MIN_GROUP = 12;
+export type FightOutcome = 'win' | 'lose' | 'draw';
+export type FightInitiator = 'us' | 'them' | 'unknown';
+export interface FightRecord {
+    outcome: FightOutcome;
+    initiator: FightInitiator;
+    stage: DeathStage;
+    thirdParty: boolean;
+    /** Teams observed in the battle group, ours included. */
+    teams: number;
+    durationSeconds: number;
+}
+export interface RoleCounts {
+    fights: number;
+    /** Fights where this member dealt the first effective damage to an opponent. */
+    initiations: number;
+    firstKnocks: number;
+    firstDowned: number;
+    knocksDealt: number;
+    timesDowned: number;
+    kills: number;
+    revives: number;
+    /** Fights in which this member knocked at least one opponent. */
+    fightsWithKnock: number;
+    /** Knocks dealt by this member, and how many of those victims were finished off by the squad. */
+    chainsDealt: number;
+    chainsFinished: number;
+}
+export interface FightMatchStats {
+    fights: FightRecord[];
+    roles: Record<string, RoleCounts>;
+}
+export declare function emptyRoleCounts(): RoleCounts;
+/**
+ * Win/lose is decided by unique victims on the observed timeline: a fight is won when more opponents than
+ * squad members were knocked or killed. Fights with no knock at all are not scored.
+ */
+export declare function analyzeFights(result: BattleReconstructionResult, matchId: string, trackedAccountIds: readonly string[]): FightMatchStats;
+export interface FightBucket {
+    key: string;
+    label: string;
+    fights: number;
+    wins: number;
+    losses: number;
+    draws: number;
+    /** Wins out of decided fights (draws excluded). */
+    winRate: RateEstimate;
+}
+export interface FightSummary {
+    schemaVersion: typeof FIGHTS_SCHEMA_VERSION;
+    fights: number;
+    overall: FightBucket;
+    byInitiator: FightBucket[];
+    byStage: FightBucket[];
+    byThirdParty: FightBucket[];
+    byDuration: FightBucket[];
+    initiatorEdge: DifferenceEstimate;
+    thirdPartyEdge: DifferenceEstimate;
+    notes: string[];
+}
+export declare function summarizeFights(items: readonly FightRecord[]): FightSummary;
+export interface RoleSummary {
+    accountId: string;
+    fights: number;
+    firstKnocks: number;
+    firstDowned: number;
+    knocksDealt: number;
+    timesDowned: number;
+    kills: number;
+    revives: number;
+}
+export interface RoleShare {
+    accountId: string;
+    name: string;
+    fights: number;
+    firstKnockShare: number | null;
+    firstDownedShare: number | null;
+    reviveShare: number | null;
+    killShare: number | null;
+    counts: RoleCounts;
+    titles: string[];
+}
+export declare const ROLE_MIN_TOTAL = 15;
+export declare const ROLE_TITLE_SHARE = 0.4;
+export declare function summarizeRoles(items: readonly FightMatchStats[], names: ReadonlyMap<string, string>): RoleShare[];

package/dist/src/fights.js

@@ -0,0 +1,238 @@
+import { newcombeDifference, wilsonInterval, } from './analytics.js';
+import { battlePlayerRef } from './battle.js';
+import { deathStageOf } from './combat-quality.js';
+export const FIGHTS_SCHEMA_VERSION = 1;
+export const FIGHT_MIN_GROUP = 12;
+export function emptyRoleCounts() {
+    return emptyRole();
+}
+function emptyRole() {
+    return {
+        fights: 0,
+        initiations: 0,
+        firstKnocks: 0,
+        firstDowned: 0,
+        knocksDealt: 0,
+        timesDowned: 0,
+        kills: 0,
+        revives: 0,
+        fightsWithKnock: 0,
+        chainsDealt: 0,
+        chainsFinished: 0,
+    };
+}
+/**
+ * Win/lose is decided by unique victims on the observed timeline: a fight is won when more opponents than
+ * squad members were knocked or killed. Fights with no knock at all are not scored.
+ */
+export function analyzeFights(result, matchId, trackedAccountIds) {
+    const stats = { fights: [], roles: {} };
+    const accountByRef = new Map(trackedAccountIds.map((accountId) => [battlePlayerRef(matchId, accountId), accountId]));
+    const trackedTeams = new Set();
+    for (const episode of result.episodes) {
+        for (const team of episode.teams)
+            if (team.tracked && team.teamRef)
+                trackedTeams.add(team.teamRef);
+    }
+    if (!trackedTeams.size)
+        return stats;
+    const mine = (ref) => ref !== null && accountByRef.has(ref);
+    const role = (ref) => (stats.roles[accountByRef.get(ref)] ??= emptyRole());
+    const samples = result.circleSamples
+        .filter((sample) => sample.phase === 'in_match' && sample.timeSeconds !== null && sample.aliveTeams !== null)
+        .sort((left, right) => left.timeSeconds - right.timeSeconds);
+    const aliveTeamsAt = (time) => {
+        let found = null;
+        for (const sample of samples) {
+            if (sample.timeSeconds > time)
+                break;
+            found = sample.aliveTeams;
+        }
+        return found;
+    };
+    for (const group of result.battles) {
+        if (!group.teamRefs.some((ref) => trackedTeams.has(ref)))
+            continue;
+        const events = [...group.timeline].sort((left, right) => left.timeSeconds - right.timeSeconds);
+        const won = new Set();
+        const lost = new Set();
+        const involved = new Set();
+        let initiator = 'unknown';
+        let firstKnockSeen = false;
+        const knockers = new Set();
+        for (const event of events) {
+            const actorTracked = event.actorTeamRef !== null && trackedTeams.has(event.actorTeamRef);
+            const victimTracked = event.victimTeamRef !== null && trackedTeams.has(event.victimTeamRef);
+            if (mine(event.actorRef))
+                involved.add(event.actorRef);
+            if (mine(event.victimRef))
+                involved.add(event.victimRef);
+            if (initiator === 'unknown' &&
+                event.type === 'DAMAGE' &&
+                (event.damage ?? 0) > 0 &&
+                actorTracked !== victimTracked) {
+                initiator = actorTracked ? 'us' : 'them';
+                if (actorTracked && mine(event.actorRef))
+                    role(event.actorRef).initiations += 1;
+            }
+            if (event.type === 'KNOCK' || event.type === 'KILL') {
+                if (event.victimRef && victimTracked && !actorTracked)
+                    lost.add(event.victimRef);
+                else if (event.victimRef && actorTracked && !victimTracked)
+                    won.add(event.victimRef);
+            }
+            if (event.type === 'KNOCK') {
+                if (!firstKnockSeen) {
+                    firstKnockSeen = true;
+                    if (mine(event.actorRef) && !victimTracked)
+                        role(event.actorRef).firstKnocks += 1;
+                    if (mine(event.victimRef) && !actorTracked)
+                        role(event.victimRef).firstDowned += 1;
+                }
+                if (mine(event.actorRef) && !victimTracked) {
+                    role(event.actorRef).knocksDealt += 1;
+                    knockers.add(event.actorRef);
+                }
+                if (mine(event.victimRef) && !actorTracked)
+                    role(event.victimRef).timesDowned += 1;
+            }
+            else if (event.type === 'KILL' && mine(event.actorRef) && !victimTracked) {
+                role(event.actorRef).kills += 1;
+            }
+            else if (event.type === 'REVIVE' && mine(event.actorRef) && victimTracked) {
+                role(event.actorRef).revives += 1;
+            }
+        }
+        for (const ref of involved)
+            role(ref).fights += 1;
+        for (const ref of knockers)
+            role(ref).fightsWithKnock += 1;
+        if (won.size + lost.size === 0)
+            continue;
+        const alive = aliveTeamsAt(group.startSeconds);
+        stats.fights.push({
+            outcome: won.size > lost.size ? 'win' : won.size < lost.size ? 'lose' : 'draw',
+            initiator,
+            stage: deathStageOf(alive),
+            thirdParty: group.possibleThirdParty.length > 0,
+            teams: group.teamRefs.length,
+            durationSeconds: group.durationSeconds,
+        });
+    }
+    const seenChains = new Set();
+    for (const episode of result.episodes) {
+        for (const chain of episode.knockChains) {
+            if (seenChains.has(chain.knockEventId))
+                continue;
+            seenChains.add(chain.knockEventId);
+            if (!mine(chain.attackerRef) || mine(chain.knockedPlayerRef))
+                continue;
+            const entry = role(chain.attackerRef);
+            entry.chainsDealt += 1;
+            if (chain.outcome === 'KILL')
+                entry.chainsFinished += 1;
+        }
+    }
+    return stats;
+}
+function bucket(key, label, records) {
+    const wins = records.filter((record) => record.outcome === 'win').length;
+    const losses = records.filter((record) => record.outcome === 'lose').length;
+    return {
+        key,
+        label,
+        fights: records.length,
+        wins,
+        losses,
+        draws: records.length - wins - losses,
+        winRate: wilsonInterval(wins, wins + losses),
+    };
+}
+export function summarizeFights(items) {
+    const group = (key, label, predicate) => bucket(key, label, items.filter(predicate));
+    const us = group('us', '我方先手', (record) => record.initiator === 'us');
+    const them = group('them', '对方先手', (record) => record.initiator === 'them');
+    const withThird = group('third', '有第三方介入', (record) => record.thirdParty);
+    const withoutThird = group('duel', '两队对战', (record) => !record.thirdParty);
+    return {
+        schemaVersion: FIGHTS_SCHEMA_VERSION,
+        fights: items.length,
+        overall: bucket('all', '全部交战', items),
+        byInitiator: [
+            us,
+            them,
+            group('unknown', '先手不明', (record) => record.initiator === 'unknown'),
+        ],
+        byStage: ['开局', '中期', '后期', '决赛圈', '未知'].map((stage) => group(stage, stage === '未知' ? '阶段未知' : stage, (record) => record.stage === stage)),
+        byThirdParty: [withThird, withoutThird],
+        byDuration: [
+            group('short', '短（<30 秒）', (record) => record.durationSeconds < 30),
+            group('medium', '中（30–90 秒）', (record) => record.durationSeconds >= 30 && record.durationSeconds < 90),
+            group('long', '长（≥90 秒）', (record) => record.durationSeconds >= 90),
+        ],
+        initiatorEdge: us.wins + us.losses >= FIGHT_MIN_GROUP && them.wins + them.losses >= FIGHT_MIN_GROUP
+            ? newcombeDifference(us.winRate, them.winRate)
+            : newcombeDifference(wilsonInterval(0, 0), wilsonInterval(0, 0)),
+        thirdPartyEdge: withThird.wins + withThird.losses >= FIGHT_MIN_GROUP &&
+            withoutThird.wins + withoutThird.losses >= FIGHT_MIN_GROUP
+            ? newcombeDifference(withThird.winRate, withoutThird.winRate)
+            : newcombeDifference(wilsonInterval(0, 0), wilsonInterval(0, 0)),
+        notes: [
+            '胜负按时间线上唯一的被击倒或击杀人数判定：对手被打倒的人数多于我方即为胜，相等为平；没有任何倒地的交战不计入。',
+            '先手 = 交战中第一次有效伤害的发起方（先手往往也意味着先发现、占位置，是相关性不是因果）；阶段 = 交战开始时场上剩余队伍数；第三方介入只是时间重叠候选，且「有第三方」等价于交战涉及 3 队及以上。',
+        ],
+    };
+}
+export const ROLE_MIN_TOTAL = 15;
+export const ROLE_TITLE_SHARE = 0.4;
+export function summarizeRoles(items, names) {
+    const totals = new Map();
+    for (const item of items) {
+        for (const [accountId, counts] of Object.entries(item.roles)) {
+            const current = totals.get(accountId) ?? emptyRole();
+            Object.keys(current).forEach((key) => {
+                current[key] += counts[key];
+            });
+            totals.set(accountId, current);
+        }
+    }
+    const sum = (key) => [...totals.values()].reduce((total, counts) => total + counts[key], 0);
+    const totalFirst = sum('firstKnocks');
+    const totalDowned = sum('firstDowned');
+    const totalRevives = sum('revives');
+    const totalKills = sum('kills');
+    const share = (value, total) => (total > 0 ? value / total : null);
+    return [...totals.entries()]
+        .map(([accountId, counts]) => {
+        const firstKnockShare = share(counts.firstKnocks, totalFirst);
+        const firstDownedShare = share(counts.firstDowned, totalDowned);
+        const reviveShare = share(counts.revives, totalRevives);
+        const killShare = share(counts.kills, totalKills);
+        const titles = [];
+        if (totalFirst >= ROLE_MIN_TOTAL &&
+            firstKnockShare !== null &&
+            firstKnockShare >= ROLE_TITLE_SHARE)
+            titles.push('开团手');
+        if (totalDowned >= ROLE_MIN_TOTAL &&
+            firstDownedShare !== null &&
+            firstDownedShare >= ROLE_TITLE_SHARE)
+            titles.push('先锋盾（最常被先倒）');
+        if (totalRevives >= ROLE_MIN_TOTAL && reviveShare !== null && reviveShare >= ROLE_TITLE_SHARE)
+            titles.push('救援担当');
+        if (totalKills >= ROLE_MIN_TOTAL && killShare !== null && killShare >= ROLE_TITLE_SHARE)
+            titles.push('收割机');
+        return {
+            accountId,
+            name: names.get(accountId) ?? '未知',
+            fights: counts.fights,
+            firstKnockShare,
+            firstDownedShare,
+            reviveShare,
+            killShare,
+            counts,
+            titles,
+        };
+    })
+        .sort((left, right) => right.fights - left.fights || left.name.localeCompare(right.name));
+}
+//# sourceMappingURL=fights.js.map