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

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

@@ -0,0 +1,73 @@
+export declare const MATCH_RELATIVE_SCHEMA_VERSION: 1;
+/** A player needs at least this many other matches before a match is compared with their usual level. */
+export declare const MATCH_RELATIVE_MIN_HISTORY = 8;
+/** Percentiles at or beyond these bounds are called out as unusually good or bad. */
+export declare const MATCH_RELATIVE_NOTABLE = 0.85;
+export type RelativeMetricKey = 'damage' | 'kills' | 'knocks' | 'assists' | 'survival' | 'dpm' | 'hitRate' | 'takedowns' | 'longestStreak' | 'wipeTakedowns' | 'timesDowned';
+export interface RelativeMetricDefinition {
+    key: RelativeMetricKey;
+    label: string;
+    /** How values are shown: whole numbers, minutes, a share, or one decimal. */
+    format: 'int' | 'minutes' | 'percent' | 'decimal';
+    higherIsBetter: boolean;
+    /** Counts toward the player's overall form score for the match. */
+    core: boolean;
+}
+export declare const RELATIVE_METRICS: readonly RelativeMetricDefinition[];
+export type RelativeValues = Partial<Record<RelativeMetricKey, number | null>>;
+export interface RelativePlayerInput {
+    accountId: string;
+    name: string;
+    current: RelativeValues;
+    /** The same metrics from the player's other matches in scope (the current match excluded). */
+    history: readonly RelativeValues[];
+}
+export interface RelativeReading {
+    key: RelativeMetricKey;
+    label: string;
+    format: RelativeMetricDefinition['format'];
+    higherIsBetter: boolean;
+    value: number | null;
+    median: number | null;
+    /** Midrank position of this match among the player's history, 0 (lowest) to 1 (highest). */
+    percentile: number | null;
+    /** Percentile oriented so 1 is always good (flipped for metrics where lower is better). */
+    goodness: number | null;
+    historyCount: number;
+}
+export interface RelativePlayer {
+    accountId: string;
+    name: string;
+    historyMatches: number;
+    metrics: RelativeReading[];
+    /** Mean goodness over the core metrics; 0.5 is an ordinary match for this player. */
+    form: number | null;
+}
+export interface MatchRelative {
+    schemaVersion: typeof MATCH_RELATIVE_SCHEMA_VERSION;
+    players: RelativePlayer[];
+    /** Placement percentile among the squad's matches in scope (1 = best placement seen). */
+    placement: {
+        value: number | null;
+        goodness: number | null;
+        historyCount: number;
+    };
+    highlights: Array<{
+        tone: 'good' | 'bad' | 'info';
+        text: string;
+    }>;
+    notes: string[];
+}
+export declare function formatRelativeValue(format: RelativeMetricDefinition['format'], value: number): string;
+/**
+ * Places one match against each member's own history: every metric becomes a percentile among that member's
+ * other matches, so "612 damage" reads as "better than 93% of your matches". Members with too short a history
+ * get no percentiles; nothing is compared across members, so a support player is not judged by a fragger's bar.
+ */
+export declare function buildMatchRelative(input: {
+    players: readonly RelativePlayerInput[];
+    placement: {
+        current: number | null;
+        history: readonly number[];
+    };
+}): MatchRelative;

package/dist/src/match-relative.js

@@ -0,0 +1,145 @@
+export const MATCH_RELATIVE_SCHEMA_VERSION = 1;
+/** A player needs at least this many other matches before a match is compared with their usual level. */
+export const MATCH_RELATIVE_MIN_HISTORY = 8;
+/** Percentiles at or beyond these bounds are called out as unusually good or bad. */
+export const MATCH_RELATIVE_NOTABLE = 0.85;
+export const RELATIVE_METRICS = [
+    { key: 'damage', label: '伤害', format: 'int', higherIsBetter: true, core: true },
+    { key: 'kills', label: '击杀', format: 'int', higherIsBetter: true, core: true },
+    { key: 'knocks', label: '击倒', format: 'int', higherIsBetter: true, core: true },
+    { key: 'assists', label: '助攻', format: 'int', higherIsBetter: true, core: false },
+    { key: 'survival', label: '存活', format: 'minutes', higherIsBetter: true, core: true },
+    { key: 'dpm', label: '每分钟伤害', format: 'decimal', higherIsBetter: true, core: true },
+    { key: 'hitRate', label: '命中率', format: 'percent', higherIsBetter: true, core: false },
+    { key: 'takedowns', label: '放倒', format: 'int', higherIsBetter: true, core: false },
+    { key: 'longestStreak', label: '最长连杀', format: 'int', higherIsBetter: true, core: false },
+    { key: 'wipeTakedowns', label: '灭队中放倒', format: 'int', higherIsBetter: true, core: false },
+    { key: 'timesDowned', label: '被击倒', format: 'int', higherIsBetter: false, core: false },
+];
+function midrank(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;
+}
+function median(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 formatRelativeValue(format, value) {
+    if (format === 'percent')
+        return `${(value * 100).toFixed(1)}%`;
+    if (format === 'minutes')
+        return `${value.toFixed(1)} 分钟`;
+    if (format === 'decimal')
+        return value.toFixed(1);
+    return String(Math.round(value));
+}
+/**
+ * Places one match against each member's own history: every metric becomes a percentile among that member's
+ * other matches, so "612 damage" reads as "better than 93% of your matches". Members with too short a history
+ * get no percentiles; nothing is compared across members, so a support player is not judged by a fragger's bar.
+ */
+export function buildMatchRelative(input) {
+    const players = input.players.map((player) => {
+        const metrics = RELATIVE_METRICS.map((definition) => {
+            const value = player.current[definition.key] ?? null;
+            const history = player.history
+                .map((values) => values[definition.key])
+                .filter((item) => typeof item === 'number' && Number.isFinite(item));
+            const enough = history.length >= MATCH_RELATIVE_MIN_HISTORY;
+            const percentile = value !== null && enough ? midrank(history, value) : null;
+            return {
+                key: definition.key,
+                label: definition.label,
+                format: definition.format,
+                higherIsBetter: definition.higherIsBetter,
+                value,
+                median: enough ? median(history) : null,
+                percentile,
+                goodness: percentile === null ? null : definition.higherIsBetter ? percentile : 1 - percentile,
+                historyCount: history.length,
+            };
+        });
+        const core = metrics.filter((reading) => RELATIVE_METRICS.find((definition) => definition.key === reading.key).core &&
+            reading.goodness !== null);
+        return {
+            accountId: player.accountId,
+            name: player.name,
+            historyMatches: player.history.length,
+            metrics,
+            form: core.length >= 3
+                ? core.reduce((sum, reading) => sum + reading.goodness, 0) / core.length
+                : null,
+        };
+    });
+    const placementHistory = input.placement.history.filter((value) => Number.isFinite(value) && value > 0);
+    const placementEnough = input.placement.current !== null && placementHistory.length >= MATCH_RELATIVE_MIN_HISTORY;
+    // Lower placement numbers are better, so goodness is the share of past matches that placed worse.
+    const placementGoodness = placementEnough
+        ? 1 - midrank(placementHistory, input.placement.current)
+        : null;
+    const highlights = [];
+    if (placementGoodness !== null) {
+        if (placementGoodness >= MATCH_RELATIVE_NOTABLE)
+            highlights.push({
+                tone: 'good',
+                text: `第 ${input.placement.current} 名，好于小队 ${(placementGoodness * 100).toFixed(0)}% 的比赛。`,
+            });
+        else if (placementGoodness <= 1 - MATCH_RELATIVE_NOTABLE)
+            highlights.push({
+                tone: 'bad',
+                text: `第 ${input.placement.current} 名，差于小队 ${((1 - placementGoodness) * 100).toFixed(0)}% 的比赛。`,
+            });
+    }
+    const ranked = players
+        .filter((player) => player.form !== null)
+        .sort((left, right) => right.form - left.form);
+    if (ranked.length >= 2 && ranked[0].form >= 0.65)
+        highlights.push({
+            tone: 'good',
+            text: `本局状态最好：${ranked[0].name}（综合分位 ${(ranked[0].form * 100).toFixed(0)}，0.5 为他的平常水平）。`,
+        });
+    const notable = players
+        .flatMap((player) => player.metrics
+        .filter((reading) => reading.goodness !== null &&
+        reading.value !== null &&
+        reading.median !== null &&
+        (reading.goodness >= MATCH_RELATIVE_NOTABLE ||
+            reading.goodness <= 1 - MATCH_RELATIVE_NOTABLE) &&
+        // A zero against a zero median is not news.
+        !(reading.value === 0 && reading.median === 0))
+        .map((reading) => ({ player, reading, strength: Math.abs(reading.goodness - 0.5) })))
+        .sort((left, right) => right.strength - left.strength || left.player.name.localeCompare(right.player.name));
+    const perPlayer = new Map();
+    for (const { player, reading } of notable) {
+        if ((perPlayer.get(player.accountId) ?? 0) >= 2 || highlights.length >= 7)
+            continue;
+        perPlayer.set(player.accountId, (perPlayer.get(player.accountId) ?? 0) + 1);
+        const good = reading.goodness >= 0.5;
+        const share = Math.round((good ? reading.goodness : 1 - reading.goodness) * 100);
+        highlights.push({
+            tone: good ? 'good' : 'bad',
+            text: `${player.name} ${reading.label} ${formatRelativeValue(reading.format, reading.value)}，${good ? '好于' : '差于'}他 ${share}% 的比赛（平时中位 ${formatRelativeValue(reading.format, reading.median)}）。`,
+        });
+    }
+    if (!highlights.length && players.some((player) => player.form !== null))
+        highlights.push({ tone: 'info', text: '这一局各项数据都在每个人的平常范围内。' });
+    return {
+        schemaVersion: MATCH_RELATIVE_SCHEMA_VERSION,
+        players,
+        placement: {
+            value: input.placement.current,
+            goodness: placementGoodness,
+            historyCount: placementHistory.length,
+        },
+        highlights,
+        notes: [
+            `分位 = 本局数值在该队员其他比赛里的位置（只和自己比），0.5 为平常水平；至少 ${MATCH_RELATIVE_MIN_HISTORY} 场历史才计算。`,
+            '综合分位 = 伤害、击杀、击倒、存活、每分钟伤害五项分位的平均。命中率、放倒、连杀、灭队只在有归档遥测的比赛里可用。',
+        ],
+    };
+}
+//# sourceMappingURL=match-relative.js.map

package/dist/src/match-relative.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"match-relative.js","sourceRoot":"","sources":["../../src/match-relative.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,6BAA6B,GAAG,CAAU,CAAC;AACxD,yGAAyG;AACzG,MAAM,CAAC,MAAM,0BAA0B,GAAG,CAAC,CAAC;AAC5C,qFAAqF;AACrF,MAAM,CAAC,MAAM,sBAAsB,GAAG,IAAI,CAAC;AAyB3C,MAAM,CAAC,MAAM,gBAAgB,GAAwC;IACnE,EAAE,GAAG,EAAE,QAAQ,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,cAAc,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE;IAC/E,EAAE,GAAG,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,cAAc,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE;IAC9E,EAAE,GAAG,EAAE,QAAQ,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,cAAc,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE;IAC/E,EAAE,GAAG,EAAE,SAAS,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,cAAc,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE;IACjF,EAAE,GAAG,EAAE,UAAU,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,cAAc,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE;IACrF,EAAE,GAAG,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,cAAc,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE;IACnF,EAAE,GAAG,EAAE,SAAS,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,cAAc,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE;IACtF,EAAE,GAAG,EAAE,WAAW,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,cAAc,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE;IACnF,EAAE,GAAG,EAAE,eAAe,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,cAAc,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE;IACzF,EAAE,GAAG,EAAE,eAAe,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,cAAc,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE;IAC1F,EAAE,GAAG,EAAE,aAAa,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,cAAc,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE;CACxF,CAAC;AA4CF,SAAS,OAAO,CAAC,MAAyB,EAAE,KAAa;IACvD,MAAM,IAAI,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,GAAG,KAAK,CAAC,CAAC,MAAM,CAAC;IAC5D,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,KAAK,KAAK,CAAC,CAAC,MAAM,CAAC;IAC/D,OAAO,CAAC,IAAI,GAAG,GAAG,GAAG,KAAK,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC;AAC9C,CAAC;AAED,SAAS,MAAM,CAAC,MAAyB;IACvC,IAAI,CAAC,MAAM,CAAC,MAAM;QAAE,OAAO,IAAI,CAAC;IAChC,MAAM,MAAM,GAAG,CAAC,GAAG,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,IAAI,GAAG,KAAK,CAAC,CAAC;IAC/D,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IAC1C,OAAO,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAE,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,GAAG,CAAC,CAAE,GAAG,MAAM,CAAC,GAAG,CAAE,CAAC,GAAG,CAAC,CAAC;AAClF,CAAC;AAED,MAAM,UAAU,mBAAmB,CACjC,MAA0C,EAC1C,KAAa;IAEb,IAAI,MAAM,KAAK,SAAS;QAAE,OAAO,GAAG,CAAC,KAAK,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC;IAChE,IAAI,MAAM,KAAK,SAAS;QAAE,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC;IAC1D,IAAI,MAAM,KAAK,SAAS;QAAE,OAAO,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;IAClD,OAAO,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC;AACnC,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,kBAAkB,CAAC,KAGlC;IACC,MAAM,OAAO,GAAqB,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE;QAC7D,MAAM,OAAO,GAAG,gBAAgB,CAAC,GAAG,CAAC,CAAC,UAAU,EAAmB,EAAE;YACnE,MAAM,KAAK,GAAG,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC;YACrD,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO;iBAC3B,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;iBACvC,MAAM,CAAC,CAAC,IAAI,EAAkB,EAAE,CAAC,OAAO,IAAI,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC;YACvF,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,0BAA0B,CAAC;YAC5D,MAAM,UAAU,GAAG,KAAK,KAAK,IAAI,IAAI,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;YAC7E,OAAO;gBACL,GAAG,EAAE,UAAU,CAAC,GAAG;gBACnB,KAAK,EAAE,UAAU,CAAC,KAAK;gBACvB,MAAM,EAAE,UAAU,CAAC,MAAM;gBACzB,cAAc,EAAE,UAAU,CAAC,cAAc;gBACzC,KAAK;gBACL,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI;gBACvC,UAAU;gBACV,QAAQ,EACN,UAAU,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,UAAU,CAAC,cAAc,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,GAAG,UAAU;gBACtF,YAAY,EAAE,OAAO,CAAC,MAAM;aAC7B,CAAC;QACJ,CAAC,CAAC,CAAC;QACH,MAAM,IAAI,GAAG,OAAO,CAAC,MAAM,CACzB,CAAC,OAAO,EAAE,EAAE,CACV,gBAAgB,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,UAAU,CAAC,GAAG,KAAK,OAAO,CAAC,GAAG,CAAE,CAAC,IAAI;YAC3E,OAAO,CAAC,QAAQ,KAAK,IAAI,CAC5B,CAAC;QACF,OAAO;YACL,SAAS,EAAE,MAAM,CAAC,SAAS;YAC3B,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,cAAc,EAAE,MAAM,CAAC,OAAO,CAAC,MAAM;YACrC,OAAO;YACP,IAAI,EACF,IAAI,CAAC,MAAM,IAAI,CAAC;gBACd,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,OAAO,EAAE,EAAE,CAAC,GAAG,GAAG,OAAO,CAAC,QAAS,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,MAAM;gBACzE,CAAC,CAAC,IAAI;SACX,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,MAAM,gBAAgB,GAAG,KAAK,CAAC,SAAS,CAAC,OAAO,CAAC,MAAM,CACrD,CAAC,KAAK,EAAE,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC,CAC/C,CAAC;IACF,MAAM,eAAe,GACnB,KAAK,CAAC,SAAS,CAAC,OAAO,KAAK,IAAI,IAAI,gBAAgB,CAAC,MAAM,IAAI,0BAA0B,CAAC;IAC5F,kGAAkG;IAClG,MAAM,iBAAiB,GAAG,eAAe;QACvC,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,gBAAgB,EAAE,KAAK,CAAC,SAAS,CAAC,OAAQ,CAAC;QACzD,CAAC,CAAC,IAAI,CAAC;IAET,MAAM,UAAU,GAAgC,EAAE,CAAC;IACnD,IAAI,iBAAiB,KAAK,IAAI,EAAE,CAAC;QAC/B,IAAI,iBAAiB,IAAI,sBAAsB;YAC7C,UAAU,CAAC,IAAI,CAAC;gBACd,IAAI,EAAE,MAAM;gBACZ,IAAI,EAAE,KAAK,KAAK,CAAC,SAAS,CAAC,OAAO,WAAW,CAAC,iBAAiB,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ;aAC1F,CAAC,CAAC;aACA,IAAI,iBAAiB,IAAI,CAAC,GAAG,sBAAsB;YACtD,UAAU,CAAC,IAAI,CAAC;gBACd,IAAI,EAAE,KAAK;gBACX,IAAI,EAAE,KAAK,KAAK,CAAC,SAAS,CAAC,OAAO,WAAW,CAAC,CAAC,CAAC,GAAG,iBAAiB,CAAC,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ;aAChG,CAAC,CAAC;IACP,CAAC;IACD,MAAM,MAAM,GAAG,OAAO;SACnB,MAAM,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,KAAK,IAAI,CAAC;SACxC,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAK,GAAG,IAAI,CAAC,IAAK,CAAC,CAAC;IACnD,IAAI,MAAM,CAAC,MAAM,IAAI,CAAC,IAAI,MAAM,CAAC,CAAC,CAAE,CAAC,IAAK,IAAI,IAAI;QAChD,UAAU,CAAC,IAAI,CAAC;YACd,IAAI,EAAE,MAAM;YACZ,IAAI,EAAE,UAAU,MAAM,CAAC,CAAC,CAAE,CAAC,IAAI,SAAS,CAAC,MAAM,CAAC,CAAC,CAAE,CAAC,IAAK,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,gBAAgB;SAC5F,CAAC,CAAC;IACL,MAAM,OAAO,GAAG,OAAO;SACpB,OAAO,CAAC,CAAC,MAAM,EAAE,EAAE,CAClB,MAAM,CAAC,OAAO;SACX,MAAM,CACL,CAAC,OAAO,EAAE,EAAE,CACV,OAAO,CAAC,QAAQ,KAAK,IAAI;QACzB,OAAO,CAAC,KAAK,KAAK,IAAI;QACtB,OAAO,CAAC,MAAM,KAAK,IAAI;QACvB,CAAC,OAAO,CAAC,QAAQ,IAAI,sBAAsB;YACzC,OAAO,CAAC,QAAQ,IAAI,CAAC,GAAG,sBAAsB,CAAC;QACjD,4CAA4C;QAC5C,CAAC,CAAC,OAAO,CAAC,KAAK,KAAK,CAAC,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,CAAC,CACjD;SACA,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,QAAS,GAAG,GAAG,CAAC,EAAE,CAAC,CAAC,CACxF;SACA,IAAI,CACH,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CACd,KAAK,CAAC,QAAQ,GAAG,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,CACtF,CAAC;IACJ,MAAM,SAAS,GAAG,IAAI,GAAG,EAAkB,CAAC;IAC5C,KAAK,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,OAAO,EAAE,CAAC;QAC1C,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,UAAU,CAAC,MAAM,IAAI,CAAC;YAAE,SAAS;QACpF,SAAS,CAAC,GAAG,CAAC,MAAM,CAAC,SAAS,EAAE,CAAC,SAAS,CAAC,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;QAC5E,MAAM,IAAI,GAAG,OAAO,CAAC,QAAS,IAAI,GAAG,CAAC;QACtC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,QAAS,CAAC,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,QAAS,CAAC,GAAG,GAAG,CAAC,CAAC;QACnF,UAAU,CAAC,IAAI,CAAC;YACd,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK;YAC3B,IAAI,EAAE,GAAG,MAAM,CAAC,IAAI,IAAI,OAAO,CAAC,KAAK,IAAI,mBAAmB,CAAC,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,KAAM,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,KAAK,KAAK,cAAc,mBAAmB,CAAC,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,MAAO,CAAC,IAAI;SACnM,CAAC,CAAC;IACL,CAAC;IACD,IAAI,CAAC,UAAU,CAAC,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,KAAK,IAAI,CAAC;QACtE,UAAU,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,qBAAqB,EAAE,CAAC,CAAC;IAEjE,OAAO;QACL,aAAa,EAAE,6BAA6B;QAC5C,OAAO;QACP,SAAS,EAAE;YACT,KAAK,EAAE,KAAK,CAAC,SAAS,CAAC,OAAO;YAC9B,QAAQ,EAAE,iBAAiB;YAC3B,YAAY,EAAE,gBAAgB,CAAC,MAAM;SACtC;QACD,UAAU;QACV,KAAK,EAAE;YACL,6CAA6C,0BAA0B,UAAU;YACjF,4DAA4D;SAC7D;KACF,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,155 @@
+import { type MatchRotation, type StoryDown, type TurningPoint } from './match-insight.js';
+export declare const MATCH_STORY_SCHEMA_VERSION: 1;
+/**
+ * A fight stays open while the squad keeps making contact with one of its opposing teams at most this far apart, and
+ * a contact with a team that is not yet in any open fight joins one only when it comes within STORY_FIGHT_JOIN_SECONDS
+ * of that fight's latest contact (a third party arriving mid-fight); otherwise it starts a separate fight. Grouping by
+ * time alone chained back-to-back fights against different teams into one fight of several minutes.
+ */
+export declare const STORY_FIGHT_GAP_SECONDS = 35;
+export declare const STORY_FIGHT_JOIN_SECONDS = 12;
+/** Route samples closer together than this are dropped to keep the payload small. */
+export declare const STORY_ROUTE_STEP_SECONDS = 10;
+/** Opposing players are sampled less often than the squad to keep the payload small. */
+export declare const STORY_ENEMY_STEP_SECONDS = 20;
+export type StoryEventKind = 'knock' | 'kill' | 'downed' | 'death' | 'revive';
+export interface StoryEvent {
+    t: number;
+    kind: StoryEventKind;
+    /** Squad member the event is about (the one who knocked, killed, was downed, died or revived). */
+    member: string;
+    /** The other side's squad member for a revive; null for enemies. */
+    other: string | null;
+    weapon: string | null;
+    meters: number | null;
+    /** True when the opponent was a player (false for the blue zone, falls and the like). */
+    byPlayer: boolean;
+    /** A kill that finished a player who was already knocked, or a death that followed a knock. */
+    afterKnock: boolean;
+}
+export type LifeState = 'alive' | 'down' | 'dead';
+export interface LifeSegment {
+    from: number;
+    to: number;
+    state: LifeState;
+}
+export interface StoryRoutePoint {
+    t: number;
+    x: number;
+    y: number;
+    vehicle: boolean;
+    down: boolean;
+    /** Present (true) only while the player is standing in the circle's gas. */
+    blue?: boolean;
+}
+export interface StoryCirclePoint {
+    t: number;
+    phase: number | null;
+    aliveTeams: number | null;
+    alivePlayers: number | null;
+    /** Safe zone and warning zone in metres. */
+    zone: {
+        x: number;
+        y: number;
+        r: number;
+    } | null;
+    warn: {
+        x: number;
+        y: number;
+        r: number;
+    } | null;
+}
+/** One opposing player's route, thinned to a sample every STORY_ENEMY_STEP_SECONDS: [t, x, y] in seconds and metres. */
+export interface StoryEnemy {
+    id: string;
+    team: string;
+    route: Array<[number, number, number]>;
+    /** When the player was knocked out of the match for good, null when they survived. */
+    diedAt: number | null;
+}
+/** An opposing team's part in one fight. */
+export interface StoryFightEnemy {
+    team: string;
+    /** Players of that team seen in the match. */
+    size: number;
+    /** Players of that team our squad took down in this fight. */
+    downed: number;
+    damageToUs: number;
+    damageFromUs: number;
+    /** Weapons they hurt us with, most damage first. */
+    weapons: string[];
+}
+export interface StoryFight {
+    index: number;
+    start: number;
+    end: number;
+    phase: number | null;
+    aliveTeams: number | null;
+    enemyTeams: number;
+    outcome: 'win' | 'lose' | 'draw' | 'skirmish';
+    initiator: 'us' | 'them' | 'unknown';
+    enemyDowns: number;
+    ourDowns: number;
+    ourKills: number;
+    revives: number;
+    damageDealt: number;
+    damageTaken: number;
+    /** Members involved with their share of the damage dealt in the fight. */
+    members: Array<{
+        member: string;
+        damage: number;
+        knocks: number;
+        downed: number;
+    }>;
+    enemies: StoryFightEnemy[];
+}
+export interface StoryPlayer {
+    member: string;
+    landing: {
+        t: number;
+        x: number;
+        y: number;
+    } | null;
+    lifeline: LifeSegment[];
+    route: StoryRoutePoint[];
+    /** Squad-member damage dealt to opponents in one-minute bins. */
+    damagePerMinute: number[];
+    /** Time of the squad member's death, null when alive at the end. */
+    diedAt: number | null;
+}
+export interface MatchStory {
+    schemaVersion: typeof MATCH_STORY_SCHEMA_VERSION;
+    mapName: string | null;
+    durationSeconds: number;
+    startTeams: number | null;
+    startPlayers: number | null;
+    events: StoryEvent[];
+    fights: StoryFight[];
+    circle: StoryCirclePoint[];
+    /** First time each circle phase is seen. */
+    phaseStarts: Array<{
+        phase: number;
+        t: number;
+    }>;
+    players: StoryPlayer[];
+    /** Every other player's thinned route, so the map can show who was where. */
+    enemies: StoryEnemy[];
+    /** Why each squad knock-down happened, from the fire the squad took and returned just before it. */
+    downs: StoryDown[];
+    /** The few moments that decided the match. */
+    turningPoints: TurningPoint[];
+    /** How the squad moved with the circle. */
+    rotation: MatchRotation;
+    /** When the last squad member went down for good, null when the squad survived to the end. */
+    squadOutAt: number | null;
+    /** Teams still alive when the squad was out (or at the end), and the squad's final position among them. */
+    teamsAtEnd: number | null;
+}
+/**
+ * Turns one raw telemetry payload into a readable story of the squad's match: who went down and when, every
+ * fight in plain terms, the route on the map against the circle, and how fast damage was dealt. Times are seconds
+ * from the match start (LogMatchStart).
+ */
+export declare function analyzeMatchStory(payload: unknown, trackedIds: ReadonlySet<string>): MatchStory;
+/** Display label for a fight result. */
+export declare function fightOutcomeText(outcome: StoryFight['outcome']): string;