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

package/dist/src/landing.js

@@ -0,0 +1,195 @@
+import { createHash } from 'node:crypto';
+import { parseTelemetryPayload, } from '@rine-kit/pubg-domain';
+import { mapDisplayName, mapSizeKm, median, newcombeDifference, wilsonInterval, } from './analytics.js';
+import { CONTEST_MIN_MATCHES } from './field.js';
+export const LANDING_SCHEMA_VERSION = 1;
+export const LANDING_EARLY_WIPE_SECONDS = 420;
+export const LANDING_CELL_KM = 1;
+export function landingPlayerRef(accountId) {
+    return createHash('sha256').update(accountId).digest('hex').slice(0, 12);
+}
+function objectValue(value) {
+    return value && typeof value === 'object' && !Array.isArray(value)
+        ? value
+        : {};
+}
+function finite(value) {
+    return typeof value === 'number' && Number.isFinite(value) ? value : null;
+}
+export function gridCell(xMeters, yMeters, mapName) {
+    const size = mapSizeKm(mapName);
+    if (size === null)
+        return null;
+    const col = Math.floor(xMeters / 1000 / LANDING_CELL_KM);
+    const row = Math.floor(yMeters / 1000 / LANDING_CELL_KM);
+    if (col < 0 || row < 0 || col >= size || row >= size)
+        return null;
+    return `${String.fromCharCode(65 + col)}${row + 1}`;
+}
+/** Reads LogParachuteLanding for the tracked squad; coordinates in telemetry are centimetres. */
+export function extractLandings(payload, match, memberIds) {
+    const seen = new Set();
+    const landings = [];
+    for (const raw of parseTelemetryPayload(payload)) {
+        const event = objectValue(raw);
+        if (event._T !== 'LogParachuteLanding')
+            continue;
+        const character = objectValue(event.character);
+        const accountId = typeof character.accountId === 'string' ? character.accountId : null;
+        if (!accountId || !memberIds.has(accountId) || seen.has(accountId))
+            continue;
+        const location = objectValue(character.location);
+        const x = finite(location.x);
+        const y = finite(location.y);
+        if (x === null || y === null)
+            continue;
+        seen.add(accountId);
+        const xMeters = x / 100;
+        const yMeters = y / 100;
+        landings.push({
+            playerRef: landingPlayerRef(accountId),
+            xMeters,
+            yMeters,
+            cell: gridCell(xMeters, yMeters, match.mapName),
+        });
+    }
+    return landings;
+}
+function modalCell(landings) {
+    const counts = new Map();
+    for (const landing of landings)
+        if (landing.cell)
+            counts.set(landing.cell, (counts.get(landing.cell) ?? 0) + 1);
+    let best = null;
+    let bestCount = 0;
+    for (const [cell, count] of [...counts.entries()].sort(([left], [right]) => left.localeCompare(right))) {
+        if (count > bestCount) {
+            best = cell;
+            bestCount = count;
+        }
+    }
+    return best;
+}
+function placementOf(players) {
+    const ranks = new Set(players
+        .map((player) => player.rank)
+        .filter((rank) => rank !== null && rank > 0));
+    return ranks.size === 1 ? [...ranks][0] : null;
+}
+export function buildLandingPreference(inputs) {
+    const byMap = new Map();
+    for (const input of inputs)
+        byMap.set(input.match.mapName || '未知地图', [
+            ...(byMap.get(input.match.mapName || '未知地图') ?? []),
+            input,
+        ]);
+    const maps = [...byMap.entries()]
+        .map(([mapName, items]) => {
+        const withLanding = items.filter((item) => item.landings.length > 0);
+        const perMatch = withLanding.map((item) => {
+            const players = item.match.players.filter((player) => item.memberIds.has(player.accountId));
+            return {
+                cell: modalCell(item.landings),
+                region: item.region ?? null,
+                placement: placementOf(players),
+                earlyWipe: players.length > 0 &&
+                    Math.max(...players.map((player) => player.survivalTime)) < LANDING_EARLY_WIPE_SECONDS,
+                damage: players.length
+                    ? players.reduce((sum, player) => sum + player.damage, 0) / players.length
+                    : 0,
+            };
+        });
+        const cells = new Map();
+        for (const row of perMatch)
+            if (row.cell)
+                cells.set(row.cell, [...(cells.get(row.cell) ?? []), row]);
+        const cellStats = [...cells.entries()]
+            .map(([cell, rows]) => {
+            const ranked = rows.filter((row) => row.placement !== null);
+            const regions = new Map();
+            for (const row of rows)
+                if (row.region)
+                    regions.set(row.region, (regions.get(row.region) ?? 0) + 1);
+            return {
+                cell,
+                region: [...regions.entries()].sort((left, right) => right[1] - left[1] || left[0].localeCompare(right[0]))[0]?.[0] ?? null,
+                matches: rows.length,
+                share: rows.length / perMatch.length,
+                top10: wilsonInterval(ranked.filter((row) => row.placement <= 10).length, ranked.length),
+                medianPlacement: median(ranked.map((row) => row.placement)),
+                earlyWipeRate: rows.length
+                    ? rows.filter((row) => row.earlyWipe).length / rows.length
+                    : null,
+                averageDamage: rows.reduce((sum, row) => sum + row.damage, 0) / rows.length,
+            };
+        })
+            .sort((left, right) => right.matches - left.matches || left.cell.localeCompare(right.cell));
+        const spreads = withLanding.flatMap((item) => {
+            if (item.landings.length < 2)
+                return [];
+            const cx = item.landings.reduce((sum, landing) => sum + landing.xMeters, 0) / item.landings.length;
+            const cy = item.landings.reduce((sum, landing) => sum + landing.yMeters, 0) / item.landings.length;
+            return item.landings.map((landing) => Math.hypot(landing.xMeters - cx, landing.yMeters - cy));
+        });
+        return {
+            mapName,
+            label: mapDisplayName(mapName),
+            sizeKm: mapSizeKm(mapName),
+            matches: items.length,
+            matchesWithLanding: withLanding.length,
+            cells: cellStats,
+            topCellRepeatRate: cellStats.length ? cellStats[0].matches / perMatch.length : null,
+            medianSpreadMeters: median(spreads),
+            points: withLanding.flatMap((item) => item.landings.map((landing) => ({
+                x: Math.round(landing.xMeters),
+                y: Math.round(landing.yMeters),
+            }))),
+        };
+    })
+        .sort((left, right) => right.matches - left.matches || left.mapName.localeCompare(right.mapName));
+    const contestRows = inputs
+        .filter((input) => input.landings.length > 0 &&
+        input.contestedTeams !== null &&
+        input.contestedTeams !== undefined)
+        .map((input) => {
+        const players = input.match.players.filter((player) => input.memberIds.has(player.accountId));
+        return {
+            contested: input.contestedTeams,
+            placement: placementOf(players),
+            earlyWipe: players.length > 0 &&
+                Math.max(...players.map((player) => player.survivalTime)) < LANDING_EARLY_WIPE_SECONDS,
+        };
+    });
+    const bucketOf = (key, label, rows) => {
+        const ranked = rows.filter((row) => row.placement !== null);
+        return {
+            key,
+            label,
+            matches: rows.length,
+            top10: wilsonInterval(ranked.filter((row) => row.placement <= 10).length, ranked.length),
+            earlyWipe: wilsonInterval(rows.filter((row) => row.earlyWipe).length, rows.length),
+            medianPlacement: median(ranked.map((row) => row.placement)),
+        };
+    };
+    const calm = bucketOf('calm', '无队伍争抢', contestRows.filter((row) => row.contested === 0));
+    const crowded = bucketOf('crowded', '有队伍争抢', contestRows.filter((row) => row.contested >= 1));
+    const enough = calm.matches >= CONTEST_MIN_MATCHES && crowded.matches >= CONTEST_MIN_MATCHES;
+    const none = newcombeDifference(wilsonInterval(0, 0), wilsonInterval(0, 0));
+    const contest = {
+        matches: contestRows.length,
+        buckets: [
+            calm,
+            bucketOf('one', '1 队争抢', contestRows.filter((row) => row.contested === 1)),
+            bucketOf('many', '2 队及以上争抢', contestRows.filter((row) => row.contested >= 2)),
+        ],
+        earlyWipeEdge: enough ? newcombeDifference(crowded.earlyWipe, calm.earlyWipe) : none,
+        top10Edge: enough ? newcombeDifference(crowded.top10, calm.top10) : none,
+    };
+    const notes = [];
+    const missing = inputs.length - inputs.filter((item) => item.landings.length > 0).length;
+    if (missing > 0)
+        notes.push(`${missing} 场没有可读的落地事件，未计入落点统计。`);
+    notes.push(`落点按 ${LANDING_CELL_KM}km 方格归类；早崩 = 全队最长生存时间不足 ${LANDING_EARLY_WIPE_SECONDS / 60} 分钟。落点与名次只是相关性，不说明因果。`);
+    return { schemaVersion: LANDING_SCHEMA_VERSION, maps, contest, notes };
+}
+//# sourceMappingURL=landing.js.map

package/dist/src/landing.js.map

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

package/dist/src/lobby.d.ts

@@ -0,0 +1,48 @@
+export declare const LOBBY_SCHEMA_VERSION: 1;
+/** Players who left the ground for less than this are dropped from the lobby so early drops do not skew percentiles. */
+export declare const LOBBY_MIN_ALIVE_MINUTES = 2;
+export declare const LOBBY_MIN_MATCHES = 20;
+export declare const LOBBY_EVEN_BAND = 0.03;
+export interface LobbyMatchStats {
+    aliveMinutes: number;
+    damagePerMinute: number;
+    knocksPerMinute: number;
+    /** Position of the player's rate among every eligible player in the match, 0 (lowest) to 1 (highest). */
+    damagePercentile: number | null;
+    knockPercentile: number | null;
+    lobbySize: number;
+}
+/**
+ * Rebuilds the whole lobby from one raw payload (damage dealt to other teams, knocks and time on the ground for every
+ * player) and places each tracked member among them on damage and knocks per minute alive.
+ */
+export declare function analyzeLobby(payload: unknown, trackedIds: ReadonlySet<string>): Record<string, LobbyMatchStats>;
+export interface LobbyInterval {
+    mean: number | null;
+    low: number | null;
+    high: number | null;
+}
+export type LobbyTier = 'above' | 'below' | 'even' | 'unknown';
+export interface LobbyEntry {
+    accountId: string;
+    name: string;
+    matches: number;
+    rank: number;
+    damage: LobbyInterval;
+    knocks: LobbyInterval;
+    /** Mean of the two percentiles per match. */
+    composite: LobbyInterval;
+    /** Against the lobby median (0.5): above or below only when the interval clears it by a margin. */
+    tier: LobbyTier;
+    medianDamagePerMinute: number | null;
+}
+export interface LobbyCombat {
+    schemaVersion: typeof LOBBY_SCHEMA_VERSION;
+    matches: number;
+    entries: LobbyEntry[];
+    /** Mean lobby size of the analysed matches. */
+    lobbySize: number | null;
+    verdict: string;
+    notes: string[];
+}
+export declare function summarizeLobby(items: ReadonlyArray<Record<string, LobbyMatchStats>>, names: ReadonlyMap<string, string>): LobbyCombat;

package/dist/src/lobby.js

@@ -0,0 +1,209 @@
+import { parseTelemetryPayload } from '@rine-kit/pubg-domain';
+import { EXPLOSIVE_DAMAGE, mulberry32, percentile, STYLE_BOOTSTRAP_RESAMPLES, STYLE_BOOTSTRAP_SEED, } from './style.js';
+export const LOBBY_SCHEMA_VERSION = 1;
+/** Players who left the ground for less than this are dropped from the lobby so early drops do not skew percentiles. */
+export const LOBBY_MIN_ALIVE_MINUTES = 2;
+export const LOBBY_MIN_MATCHES = 20;
+export const LOBBY_EVEN_BAND = 0.03;
+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 midrankPercentile(values, value) {
+    const less = values.filter((other) => other < value).length;
+    const equal = values.filter((other) => other === value).length;
+    return (less + 0.5 * equal) / values.length;
+}
+/**
+ * Rebuilds the whole lobby from one raw payload (damage dealt to other teams, knocks and time on the ground for every
+ * player) and places each tracked member among them on damage and knocks per minute alive.
+ */
+export function analyzeLobby(payload, trackedIds) {
+    const players = new Map();
+    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 (!Number.isFinite(time))
+            continue;
+        const phase = num(obj(event.common).isGame);
+        if (type === 'LogParachuteLanding') {
+            const character = obj(event.character);
+            const id = typeof character.accountId === 'string' ? character.accountId : null;
+            if (id && !players.has(id))
+                players.set(id, {
+                    team: String(character.teamId ?? ''),
+                    user: character.type === 'user',
+                    landed: time,
+                    seen: time,
+                    end: null,
+                    damage: 0,
+                    knocks: 0,
+                });
+        }
+        else if (type === 'LogPlayerPosition') {
+            const id = typeof obj(event.character).accountId === 'string'
+                ? obj(event.character).accountId
+                : null;
+            const entry = id ? players.get(id) : undefined;
+            if (entry && time > entry.seen)
+                entry.seen = time;
+        }
+        else if (type === 'LogPlayerTakeDamage') {
+            const category = typeof event.damageTypeCategory === 'string' ? event.damageTypeCategory : '';
+            if (phase === null ||
+                phase < 1 ||
+                (category !== 'Damage_Gun' && !EXPLOSIVE_DAMAGE.has(category)))
+                continue;
+            const damage = num(event.damage);
+            const attacker = obj(event.attacker);
+            const victim = obj(event.victim);
+            const id = typeof attacker.accountId === 'string' ? attacker.accountId : null;
+            const entry = id ? players.get(id) : undefined;
+            if (entry &&
+                damage !== null &&
+                damage > 0 &&
+                String(attacker.teamId ?? '') !== String(victim.teamId ?? ''))
+                entry.damage += damage;
+        }
+        else if (type === 'LogPlayerMakeGroggy') {
+            const attacker = obj(event.attacker);
+            const victim = obj(event.victim);
+            const id = typeof attacker.accountId === 'string' ? attacker.accountId : null;
+            const entry = id ? players.get(id) : undefined;
+            if (entry && String(attacker.teamId ?? '') !== String(victim.teamId ?? ''))
+                entry.knocks += 1;
+        }
+        else if (type === 'LogPlayerKill' || type === 'LogPlayerKillV2') {
+            const id = typeof obj(event.victim).accountId === 'string'
+                ? obj(event.victim).accountId
+                : null;
+            const entry = id ? players.get(id) : undefined;
+            if (entry && entry.end === null)
+                entry.end = time;
+        }
+    }
+    const rows = [...players.entries()].map(([id, entry]) => {
+        const endAt = entry.end ?? entry.seen;
+        const aliveMinutes = Math.max(0, (endAt - entry.landed) / 60000);
+        return {
+            id,
+            aliveMinutes,
+            dpm: aliveMinutes > 0 ? entry.damage / aliveMinutes : 0,
+            kpm: aliveMinutes > 0 ? entry.knocks / aliveMinutes : 0,
+            eligible: entry.user && aliveMinutes >= LOBBY_MIN_ALIVE_MINUTES,
+        };
+    });
+    const lobby = rows.filter((row) => row.eligible);
+    const result = {};
+    for (const row of rows) {
+        if (!trackedIds.has(row.id))
+            continue;
+        result[row.id] = {
+            aliveMinutes: row.aliveMinutes,
+            damagePerMinute: row.dpm,
+            knocksPerMinute: row.kpm,
+            damagePercentile: row.eligible && lobby.length >= 10
+                ? midrankPercentile(lobby.map((other) => other.dpm), row.dpm)
+                : null,
+            knockPercentile: row.eligible && lobby.length >= 10
+                ? midrankPercentile(lobby.map((other) => other.kpm), row.kpm)
+                : null,
+            lobbySize: lobby.length,
+        };
+    }
+    return result;
+}
+function bootstrapMean(values, seed) {
+    if (values.length === 0)
+        return { mean: null, low: null, high: null };
+    const mean = values.reduce((sum, value) => sum + value, 0) / values.length;
+    if (values.length < LOBBY_MIN_MATCHES)
+        return { mean, low: null, high: null };
+    const rng = mulberry32(seed);
+    const means = [];
+    for (let round = 0; round < STYLE_BOOTSTRAP_RESAMPLES; round += 1) {
+        let total = 0;
+        for (let index = 0; index < values.length; index += 1)
+            total += values[Math.floor(rng() * values.length)];
+        means.push(total / values.length);
+    }
+    means.sort((left, right) => left - right);
+    return { mean, low: percentile(means, 0.025), high: percentile(means, 0.975) };
+}
+function medianOf(values) {
+    if (!values.length)
+        return null;
+    const sorted = [...values].sort((left, right) => left - right);
+    const mid = Math.floor(sorted.length / 2);
+    return sorted.length % 2 ? sorted[mid] : (sorted[mid - 1] + sorted[mid]) / 2;
+}
+export function summarizeLobby(items, names) {
+    const perPlayer = new Map();
+    const sizes = [];
+    for (const item of items) {
+        for (const [id, stats] of Object.entries(item)) {
+            if (stats.damagePercentile === null || stats.knockPercentile === null)
+                continue;
+            perPlayer.set(id, [...(perPlayer.get(id) ?? []), stats]);
+            sizes.push(stats.lobbySize);
+        }
+    }
+    const entries = [...perPlayer.entries()]
+        .map(([accountId, rows], index) => {
+        const damage = bootstrapMean(rows.map((row) => row.damagePercentile), STYLE_BOOTSTRAP_SEED + 11 + index);
+        const knocks = bootstrapMean(rows.map((row) => row.knockPercentile), STYLE_BOOTSTRAP_SEED + 31 + index);
+        const composite = bootstrapMean(rows.map((row) => (row.damagePercentile + row.knockPercentile) / 2), STYLE_BOOTSTRAP_SEED + 53 + index);
+        const tier = composite.mean === null || composite.low === null || composite.high === null
+            ? 'unknown'
+            : composite.low > 0.5 + LOBBY_EVEN_BAND
+                ? 'above'
+                : composite.high < 0.5 - LOBBY_EVEN_BAND
+                    ? 'below'
+                    : 'even';
+        return {
+            accountId,
+            name: names.get(accountId) ?? '未知',
+            matches: rows.length,
+            rank: 0,
+            damage,
+            knocks,
+            composite,
+            tier,
+            medianDamagePerMinute: medianOf(rows.map((row) => row.damagePerMinute)),
+        };
+    })
+        .sort((left, right) => (right.composite.mean ?? -1) - (left.composite.mean ?? -1) ||
+        left.name.localeCompare(right.name));
+    entries.forEach((entry, index) => {
+        entry.rank = index + 1;
+    });
+    const leader = entries[0];
+    const second = entries[1];
+    const separated = leader &&
+        second &&
+        leader.composite.low !== null &&
+        second.composite.high !== null &&
+        leader.composite.low > second.composite.high;
+    const verdict = !leader || leader.composite.mean === null || items.length < LOBBY_MIN_MATCHES
+        ? `有可用全场数据的比赛不足 ${LOBBY_MIN_MATCHES} 场，暂不比较。`
+        : separated
+            ? `在全场约 ${Math.round(sizes.reduce((sum, value) => sum + value, 0) / Math.max(1, sizes.length))} 名玩家里，${leader.name} 的输出分位明显高于其他队友（${(leader.composite.mean * 100).toFixed(0)} 对 ${(second.composite.mean * 100).toFixed(0)}，区间不重叠）。`
+            : `在全场玩家里，四人的输出分位差距在抽样误差内（最高 ${leader.name} ${(leader.composite.mean * 100).toFixed(0)}，最低 ${entries.at(-1).name} ${((entries.at(-1).composite.mean ?? 0) * 100).toFixed(0)}），不能断定谁更强。`;
+    return {
+        schemaVersion: LOBBY_SCHEMA_VERSION,
+        matches: items.length,
+        entries,
+        lobbySize: sizes.length ? sizes.reduce((sum, value) => sum + value, 0) / sizes.length : null,
+        verdict,
+        notes: [
+            `分位 = 该队员每存活分钟的枪械伤害（或击倒）在本场所有真人玩家里的位置，0.50 即全场中位数；只统计落地后至少 ${LOBBY_MIN_ALIVE_MINUTES} 分钟的玩家，避免开局就被淘汰的人把分布拉偏。`,
+            '综合 = 伤害分位与击倒分位的平均；区间由按场次重抽样得到。分位以每分钟速率计算，对存活时间长短的偏差已做归一，但同一场里活得更久的人面对的对手更强，所以不要把它当作绝对水平。',
+        ],
+    };
+}
+//# sourceMappingURL=lobby.js.map

package/dist/src/lobby.js.map

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

package/dist/src/match-insight.d.ts

@@ -0,0 +1,165 @@
+import { type RateEstimate } from './analytics.js';
+import type { MatchStory, StoryEvent, StoryFight } from './match-story.js';
+export declare const MATCH_INSIGHT_SCHEMA_VERSION: 1;
+/** How far back a down looks for the fire that caused it. */
+export declare const DOWN_LOOKBACK_SECONDS = 20;
+/** A shot taken from at least this far is a long-range pick. */
+export declare const DOWN_FAR_METERS = 150;
+/** A member this far from every teammate is on their own. */
+export declare const DOWN_ALONE_METERS = 150;
+/** Opposing players within this distance count as nearby. */
+export declare const DOWN_NEARBY_METERS = 300;
+/** One contact between the squad and an opposing team, as collected while reading the telemetry. */
+export interface StoryContact {
+    t: number;
+    kind: 'dealt' | 'taken' | 'knock' | 'downed' | 'kill' | 'revive';
+    member: string;
+    enemyTeam: string | null;
+    amount: number;
+    victim: string | null;
+    weapon?: string | null;
+}
+export interface BlueDamage {
+    t: number;
+    member: string;
+    amount: number;
+}
+export type DownCause = 'ambush_far' | 'ambush_close' | 'crossfire' | 'isolated' | 'lost_duel' | 'bluezone' | 'environment';
+export declare const DOWN_CAUSES: ReadonlyArray<{
+    key: DownCause;
+    label: string;
+    advice: string;
+}>;
+export interface StoryDown {
+    t: number;
+    member: string;
+    cause: DownCause;
+    attackerTeam: string | null;
+    weapon: string | null;
+    meters: number | null;
+    /** Damage the squad dealt to the attacking team in the lookback window (0 = no return fire). */
+    returnDamage: number;
+    /** Damage the squad took from opposing teams in the lookback window. */
+    takenDamage: number;
+    /** Distinct opposing teams that damaged the squad in the lookback window. */
+    teamsHitting: number;
+    nearestTeammate: number | null;
+    alone: boolean | null;
+    /** Opposing teams with a player within DOWN_NEARBY_METERS when the down happened. */
+    teamsNearby: number | null;
+    phase: number | null;
+    outcome: 'revived' | 'died' | 'unknown';
+    /** Seconds from the down to the revive or the death. */
+    afterSeconds: number | null;
+}
+export declare function buildDowns(story: MatchStory, contacts: readonly StoryContact[], blueDamage: readonly BlueDamage[]): StoryDown[];
+export interface TurningPoint {
+    kind: 'first_loss' | 'collapse' | 'costly' | 'decisive' | 'final_fight';
+    t: number;
+    fight: number | null;
+    member: string | null;
+    /** Consecutive fights in a collapse, or the down/takedown balance of a single fight. */
+    count: number;
+}
+export declare function buildTurningPoints(story: MatchStory): TurningPoint[];
+/**
+ * In the telemetry `poisonGasWarning*` is the NEXT safe circle (the white circle, fixed for a whole phase) and
+ * `safetyZone*` is the gas wall closing in on it (the blue circle, shrinking once the phase starts to close).
+ * A squad is late into a circle when it is not inside the white circle by the time the blue wall starts to move.
+ */
+export interface RotationEpoch {
+    phase: number | null;
+    start: number;
+    end: number;
+    radius: number;
+    /** How far outside the new safe circle the squad stood when it appeared (0 = already inside). */
+    outsideAtStart: number;
+    /** Seconds from the circle appearing to the squad being inside it; null when it never got in. */
+    enteredAfter: number | null;
+    /** Seconds from the circle appearing to the gas wall starting to close; null in the final phases that never close. */
+    shrinkAfter: number | null;
+    /** Seconds the squad was inside before the wall moved (negative = the wall caught it); null when either is unknown. */
+    margin: number | null;
+    blueSeconds: number;
+    blueDamage: number;
+    distance: number;
+    vehicleShare: number | null;
+}
+export interface MatchRotation {
+    epochs: RotationEpoch[];
+    blueSeconds: number;
+    blueDamage: number;
+    distance: number;
+    vehicleShare: number | null;
+    /** Seconds from the first landing to the first fight. */
+    landingToFight: number | null;
+    /** Circles from phase 3 on that the squad had not reached when the wall started to close (or never reached). */
+    lateEntries: number;
+    circlesChecked: number;
+}
+export declare function buildRotation(story: MatchStory, blueDamage: readonly BlueDamage[]): MatchRotation;
+export interface DownSummary {
+    matches: number;
+    downs: number;
+    byCause: Array<{
+        cause: DownCause;
+        label: string;
+        advice: string;
+        count: number;
+        share: number;
+        died: number;
+    }>;
+    alone: RateEstimate;
+    /** Downs from which the member was brought back. */
+    revived: RateEstimate;
+    noReturnFire: RateEstimate;
+    byMember: Array<{
+        member: string;
+        downs: number;
+        causes: Array<{
+            cause: DownCause;
+            count: number;
+        }>;
+    }>;
+    byStage: Array<{
+        stage: 'early' | 'mid' | 'late';
+        downs: number;
+        noReturnFire: number;
+    }>;
+    insights: string[];
+}
+export declare function summarizeDowns(items: ReadonlyArray<{
+    downs: StoryDown[];
+}>, names: ReadonlyMap<string, string>): DownSummary;
+export interface RotationSummary {
+    matches: number;
+    /** Matches in which the squad took any damage from the circle. */
+    bluePenaltyRate: RateEstimate;
+    averageBlueDamage: number | null;
+    averageBlueSeconds: number | null;
+    averageDistanceKm: number | null;
+    vehicleShare: number | null;
+    averageLandingToFight: number | null;
+    lateEntry: RateEstimate;
+    /** Average seconds the squad was inside before the wall moved (negative = caught by it). */
+    averageMargin: number | null;
+    byPhase: Array<{
+        phase: number;
+        circles: number;
+        lateRate: number | null;
+        medianEnter: number | null;
+        averageMargin: number | null;
+        averageOutside: number | null;
+        averageDistance: number | null;
+    }>;
+    insights: string[];
+}
+/**
+ * Descriptive only. Comparing placement between matches with much and little gas damage would be misleading: a squad
+ * that survives longer goes through more circles and so takes more gas, which makes the gas look good for placement.
+ */
+export declare function summarizeRotation(items: ReadonlyArray<{
+    rotation: MatchRotation;
+}>): RotationSummary;
+export declare function downCauseLabel(cause: DownCause): string;
+export type { StoryEvent, StoryFight };