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

package/dist/src/review/fight-detector.js

@@ -0,0 +1,138 @@
+import { dedupeRelevantCombatEvents, isOpponentOffensiveEvent, isOpponentReviveEvent, isTrackedOffensiveEvent, isTrackedReviveEvent, } from './combat-scope.js';
+const FIGHT_GAP_SECONDS = 28;
+function resultFor(teamKills, opponentKills) {
+    if (teamKills > 0 && opponentKills === 0)
+        return 'WIN';
+    if (opponentKills > 0 && teamKills === 0)
+        return 'LOSS';
+    if (teamKills > 0 && opponentKills > 0)
+        return 'TRADE';
+    return 'UNKNOWN';
+}
+function timeOf(event) {
+    return event.timeSeconds ?? Number.POSITIVE_INFINITY;
+}
+function sortEvents(events) {
+    return [...events].sort((left, right) => timeOf(left) - timeOf(right) || left.id.localeCompare(right.id));
+}
+export function detectFights(events, teamIds) {
+    const relevant = dedupeRelevantCombatEvents(events, teamIds);
+    const seeds = sortEvents(relevant
+        .filter((event) => isTrackedOffensiveEvent(event, teamIds) || isOpponentOffensiveEvent(event, teamIds))
+        .filter((event) => event.timeSeconds !== null));
+    const revives = sortEvents(relevant
+        .filter((event) => isTrackedReviveEvent(event, teamIds) || isOpponentReviveEvent(event, teamIds))
+        .filter((event) => event.timeSeconds !== null));
+    const seedGroups = [];
+    for (const event of seeds) {
+        const current = seedGroups.at(-1);
+        const previousTime = current?.at(-1)?.timeSeconds;
+        if (!current ||
+            previousTime === null ||
+            previousTime === undefined ||
+            timeOf(event) - previousTime > FIGHT_GAP_SECONDS) {
+            seedGroups.push([event]);
+        }
+        else {
+            current.push(event);
+        }
+    }
+    const assignedRevives = new Set();
+    return seedGroups.map((seedGroup, index) => {
+        const start = seedGroup[0]?.timeSeconds ?? 0;
+        const seedEnd = seedGroup.at(-1)?.timeSeconds ?? start;
+        const group = sortEvents([
+            ...seedGroup,
+            ...revives.filter((event) => {
+                const time = event.timeSeconds;
+                if (time === null ||
+                    assignedRevives.has(event.id) ||
+                    time < start ||
+                    time > seedEnd + FIGHT_GAP_SECONDS)
+                    return false;
+                assignedRevives.add(event.id);
+                return true;
+            }),
+        ]);
+        const end = group.at(-1)?.timeSeconds ?? seedEnd;
+        const teamEvents = group.filter((event) => isTrackedOffensiveEvent(event, teamIds) || isTrackedReviveEvent(event, teamIds));
+        const opponentEvents = group.filter((event) => isOpponentOffensiveEvent(event, teamIds) || isOpponentReviveEvent(event, teamIds));
+        const teamDamage = teamEvents
+            .filter((event) => event.type === 'DAMAGE')
+            .reduce((sum, event) => sum + event.damage, 0);
+        const receivedDamage = opponentEvents
+            .filter((event) => event.type === 'DAMAGE')
+            .reduce((sum, event) => sum + event.damage, 0);
+        const teamKnocks = teamEvents.filter((event) => event.type === 'KNOCK').length;
+        const receivedKnocks = opponentEvents.filter((event) => event.type === 'KNOCK').length;
+        const teamKills = teamEvents.filter((event) => event.type === 'KILL').length;
+        const receivedKills = opponentEvents.filter((event) => event.type === 'KILL').length;
+        const teamRevives = teamEvents.filter((event) => event.type === 'REVIVE').length;
+        const receivedRevives = opponentEvents.filter((event) => event.type === 'REVIVE').length;
+        const participants = [
+            ...new Set(group.flatMap((event) => [event.actorId, event.victimId].filter((id) => Boolean(id)))),
+        ];
+        const opponentTeamIds = [
+            ...new Set(group.flatMap((event) => {
+                const ids = [];
+                if (event.actorId && !teamIds.has(event.actorId) && event.actorTeamId)
+                    ids.push(event.actorTeamId);
+                if (event.victimId && !teamIds.has(event.victimId) && event.victimTeamId)
+                    ids.push(event.victimTeamId);
+                return ids;
+            })),
+        ].sort();
+        const byPlayer = new Map();
+        for (const event of teamEvents) {
+            if (!event.actorId || !teamIds.has(event.actorId))
+                continue;
+            const score = event.damage + event.knocks * 250 + event.kills * 500 + (event.type === 'REVIVE' ? 100 : 0);
+            byPlayer.set(event.actorId, (byPlayer.get(event.actorId) ?? 0) + score);
+        }
+        const keyPlayers = [...byPlayer.entries()]
+            .sort((left, right) => right[1] - left[1] || left[0].localeCompare(right[0]))
+            .slice(0, 3)
+            .map(([playerId]) => playerId);
+        const location = group.find((event) => event.location?.reliable && event.location.label)
+            ?.location?.label;
+        const importanceScore = Math.round(teamDamage +
+            receivedDamage * 0.75 +
+            (teamKnocks + receivedKnocks) * 250 +
+            (teamKills + receivedKills) * 500 +
+            (teamRevives + receivedRevives) * 100);
+        return {
+            id: `fight-${index + 1}`,
+            start,
+            end,
+            participants,
+            damage: teamDamage,
+            knocks: teamKnocks,
+            kills: teamKills,
+            revives: teamRevives,
+            teamDamage,
+            teamKnocks,
+            teamKills,
+            teamRevives,
+            receivedDamage,
+            receivedKnocks,
+            receivedKills,
+            receivedRevives,
+            opponentTeamIds,
+            eventCount: group.length,
+            result: resultFor(teamKills, receivedKills),
+            importanceScore,
+            keyPlayers,
+            ...(location ? { location } : {}),
+            evidenceIds: [...new Set(group.map((event) => event.id))],
+        };
+    });
+}
+export function selectKeyFights(fights, limit = 3) {
+    return [...fights]
+        .sort((left, right) => right.importanceScore - left.importanceScore ||
+        left.start - right.start ||
+        left.id.localeCompare(right.id))
+        .slice(0, limit)
+        .sort((left, right) => left.start - right.start || left.id.localeCompare(right.id));
+}
+//# sourceMappingURL=fight-detector.js.map

package/dist/src/review/fight-detector.js.map

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

package/dist/src/review/fight-integrity-validator.d.ts

@@ -0,0 +1,13 @@
+import type { ReviewPlayerFacts, Fight, FightIntegrityResult } from './types.js';
+import type { NormalizedTelemetryEvent } from './telemetry-events.js';
+export declare const FIGHT_DAMAGE_TOLERANCE = 1;
+export interface FightIntegrityInput {
+    fights: Fight[];
+    events: NormalizedTelemetryEvent[];
+    teamIds: Set<string>;
+    players: ReviewPlayerFacts[];
+    matchTeamKills: number;
+    matchTeamDamage: number;
+    matchTeamDBNOs: number;
+}
+export declare function validateFightIntegrity(input: FightIntegrityInput): FightIntegrityResult;

package/dist/src/review/fight-integrity-validator.js

@@ -0,0 +1,134 @@
+import { dedupeRelevantCombatEvents, isRelevantCombatEvent, isTrackedOffensiveEvent, } from './combat-scope.js';
+const COMBAT_TYPES = new Set([
+    'DAMAGE',
+    'KNOCK',
+    'KILL',
+    'REVIVE',
+]);
+export const FIGHT_DAMAGE_TOLERANCE = 1;
+function candidateEvents(events) {
+    return events.filter((event) => COMBAT_TYPES.has(event.type));
+}
+function eventMetrics(events, teamIds) {
+    const deduped = dedupeRelevantCombatEvents(events, teamIds);
+    return {
+        kills: deduped.filter((event) => isTrackedOffensiveEvent(event, teamIds) && event.type === 'KILL').length,
+        knocks: deduped.filter((event) => isTrackedOffensiveEvent(event, teamIds) && event.type === 'KNOCK').length,
+        damage: deduped
+            .filter((event) => isTrackedOffensiveEvent(event, teamIds) && event.type === 'DAMAGE')
+            .reduce((sum, event) => sum + event.damage, 0),
+    };
+}
+export function validateFightIntegrity(input) {
+    const candidates = candidateEvents(input.events);
+    const relevantRaw = candidates.filter((event) => isRelevantCombatEvent(event, input.teamIds));
+    const relevant = dedupeRelevantCombatEvents(relevantRaw, input.teamIds);
+    const eventById = new Map(input.events.map((event) => [event.id, event]));
+    const perPlayer = new Map();
+    const eventAssignments = new Map();
+    const errors = [];
+    const addPlayerMetrics = (playerId, metrics) => {
+        const current = perPlayer.get(playerId) ?? { kills: 0, knocks: 0, damage: 0 };
+        current.kills += metrics.kills;
+        current.knocks += metrics.knocks;
+        current.damage += metrics.damage;
+        perPlayer.set(playerId, current);
+    };
+    const fightMetrics = input.fights.map((fight) => {
+        const fightEvents = [...new Set(fight.evidenceIds)]
+            .map((id) => eventById.get(id))
+            .filter((event) => Boolean(event));
+        const relevantFightEvents = dedupeRelevantCombatEvents(fightEvents, input.teamIds);
+        const metrics = eventMetrics(relevantFightEvents, input.teamIds);
+        const teamDamage = metrics.damage;
+        const teamKills = metrics.kills;
+        const teamKnocks = metrics.knocks;
+        for (const playerId of input.teamIds) {
+            addPlayerMetrics(playerId, eventMetrics(relevantFightEvents.filter((event) => event.actorId === playerId), input.teamIds));
+        }
+        for (const id of new Set(fight.evidenceIds)) {
+            const assigned = eventAssignments.get(id) ?? [];
+            assigned.push(fight.id);
+            eventAssignments.set(id, assigned);
+        }
+        const missingEvidence = fight.evidenceIds.some((id) => !eventById.has(id));
+        const irrelevantEvidence = fightEvents.some((event) => !isRelevantCombatEvent(event, input.teamIds));
+        const declaredMetricsMatch = fight.teamKills === teamKills &&
+            fight.kills === teamKills &&
+            fight.teamKnocks === teamKnocks &&
+            fight.knocks === teamKnocks &&
+            Math.abs(fight.teamDamage - teamDamage) <= FIGHT_DAMAGE_TOLERANCE &&
+            Math.abs(fight.damage - teamDamage) <= FIGHT_DAMAGE_TOLERANCE &&
+            fight.eventCount === relevantFightEvents.length;
+        const integrityPass = !missingEvidence &&
+            !irrelevantEvidence &&
+            declaredMetricsMatch &&
+            teamKills <= input.matchTeamKills &&
+            teamKnocks <= input.matchTeamDBNOs &&
+            teamDamage <= input.matchTeamDamage + FIGHT_DAMAGE_TOLERANCE;
+        return {
+            fight,
+            metrics: { teamKills, teamKnocks, teamDamage },
+            id: fight.id,
+            duration: Math.max(0, fight.end - fight.start),
+            opponentTeamIds: fight.opponentTeamIds,
+            eventCount: relevantFightEvents.length,
+            teamKills,
+            teamKnocks,
+            teamDamage,
+            receivedDamage: fight.receivedDamage,
+            integrityPass,
+            missingEvidence,
+            irrelevantEvidence,
+            declaredMetricsMatch,
+        };
+    });
+    for (const [eventId, fightIds] of eventAssignments) {
+        if (fightIds.length > 1)
+            errors.push(`combat_event_assigned_to_multiple_fights:${eventId}`);
+    }
+    for (const diagnostic of fightMetrics) {
+        if (diagnostic.missingEvidence)
+            errors.push(`fight_missing_evidence:${diagnostic.id}`);
+        if (diagnostic.irrelevantEvidence)
+            errors.push(`fight_contains_irrelevant_event:${diagnostic.id}`);
+        if (!diagnostic.declaredMetricsMatch)
+            errors.push(`fight_metrics_mismatch:${diagnostic.id}`);
+    }
+    const totalKills = fightMetrics.reduce((sum, item) => sum + item.metrics.teamKills, 0);
+    const totalKnocks = fightMetrics.reduce((sum, item) => sum + item.metrics.teamKnocks, 0);
+    const totalDamage = fightMetrics.reduce((sum, item) => sum + item.metrics.teamDamage, 0);
+    if (totalKills > input.matchTeamKills)
+        errors.push('fight_team_kills_exceed_match_kills');
+    if (totalKnocks > input.matchTeamDBNOs)
+        errors.push('fight_team_knocks_exceed_match_dbnos');
+    if (totalDamage > input.matchTeamDamage + FIGHT_DAMAGE_TOLERANCE)
+        errors.push('fight_team_damage_exceed_match_damage');
+    for (const player of input.players) {
+        const metrics = perPlayer.get(player.playerId) ?? { kills: 0, knocks: 0, damage: 0 };
+        if (metrics.kills > player.kills)
+            errors.push(`fight_player_kills_exceed_match:${player.playerId}`);
+        if (metrics.knocks > player.dbnos)
+            errors.push(`fight_player_knocks_exceed_match:${player.playerId}`);
+        if (metrics.damage > player.damage + FIGHT_DAMAGE_TOLERANCE)
+            errors.push(`fight_player_damage_exceed_match:${player.playerId}`);
+    }
+    const pass = errors.length === 0 && fightMetrics.every((fight) => fight.integrityPass);
+    return {
+        pass,
+        status: pass ? 'FIGHT_ANALYTICS_VALID' : 'FIGHT_ANALYTICS_INVALID',
+        diagnostics: {
+            matchTeamKills: input.matchTeamKills,
+            matchTeamDamage: input.matchTeamDamage,
+            matchTeamDBNOs: input.matchTeamDBNOs,
+            candidateCombatEvents: candidates.length,
+            trackedRelevantEvents: relevant.length,
+            ignoredGlobalEvents: Math.max(0, candidates.length - relevantRaw.length),
+            fightCount: input.fights.length,
+            damageTolerance: FIGHT_DAMAGE_TOLERANCE,
+            fights: fightMetrics.map(({ fight: _fight, metrics: _metrics, missingEvidence: _missing, irrelevantEvidence: _irrelevant, declaredMetricsMatch: _declared, ...diagnostic }) => diagnostic),
+        },
+        errors: [...new Set(errors)],
+    };
+}
+//# sourceMappingURL=fight-integrity-validator.js.map

package/dist/src/review/fight-integrity-validator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fight-integrity-validator.js","sourceRoot":"","sources":["../../../src/review/fight-integrity-validator.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,0BAA0B,EAC1B,qBAAqB,EACrB,uBAAuB,GACxB,MAAM,mBAAmB,CAAC;AAE3B,MAAM,YAAY,GAAG,IAAI,GAAG,CAAmC;IAC7D,QAAQ;IACR,OAAO;IACP,MAAM;IACN,QAAQ;CACT,CAAC,CAAC;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,CAAC;AAExC,SAAS,eAAe,CAAC,MAAkC;IACzD,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,YAAY,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;AAChE,CAAC;AAED,SAAS,YAAY,CACnB,MAAkC,EAClC,OAAoB;IAEpB,MAAM,OAAO,GAAG,0BAA0B,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC5D,OAAO;QACL,KAAK,EAAE,OAAO,CAAC,MAAM,CACnB,CAAC,KAAK,EAAE,EAAE,CAAC,uBAAuB,CAAC,KAAK,EAAE,OAAO,CAAC,IAAI,KAAK,CAAC,IAAI,KAAK,MAAM,CAC5E,CAAC,MAAM;QACR,MAAM,EAAE,OAAO,CAAC,MAAM,CACpB,CAAC,KAAK,EAAE,EAAE,CAAC,uBAAuB,CAAC,KAAK,EAAE,OAAO,CAAC,IAAI,KAAK,CAAC,IAAI,KAAK,OAAO,CAC7E,CAAC,MAAM;QACR,MAAM,EAAE,OAAO;aACZ,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,uBAAuB,CAAC,KAAK,EAAE,OAAO,CAAC,IAAI,KAAK,CAAC,IAAI,KAAK,QAAQ,CAAC;aACrF,MAAM,CAAC,CAAC,GAAG,EAAE,KAAK,EAAE,EAAE,CAAC,GAAG,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC;KACjD,CAAC;AACJ,CAAC;AAYD,MAAM,UAAU,sBAAsB,CAAC,KAA0B;IAC/D,MAAM,UAAU,GAAG,eAAe,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IACjD,MAAM,WAAW,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,qBAAqB,CAAC,KAAK,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC;IAC9F,MAAM,QAAQ,GAAG,0BAA0B,CAAC,WAAW,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;IACxE,MAAM,SAAS,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC;IAC1E,MAAM,SAAS,GAAG,IAAI,GAAG,EAA6D,CAAC;IACvF,MAAM,gBAAgB,GAAG,IAAI,GAAG,EAAoB,CAAC;IACrD,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,MAAM,gBAAgB,GAAG,CACvB,QAAgB,EAChB,OAA0D,EACpD,EAAE;QACR,MAAM,OAAO,GAAG,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC;QAC9E,OAAO,CAAC,KAAK,IAAI,OAAO,CAAC,KAAK,CAAC;QAC/B,OAAO,CAAC,MAAM,IAAI,OAAO,CAAC,MAAM,CAAC;QACjC,OAAO,CAAC,MAAM,IAAI,OAAO,CAAC,MAAM,CAAC;QACjC,SAAS,CAAC,GAAG,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IACnC,CAAC,CAAC;IACF,MAAM,YAAY,GAAG,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE;QAC9C,MAAM,WAAW,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;aAChD,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;aAC9B,MAAM,CAAC,CAAC,KAAK,EAAqC,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC;QACxE,MAAM,mBAAmB,GAAG,0BAA0B,CAAC,WAAW,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;QACnF,MAAM,OAAO,GAAG,YAAY,CAAC,mBAAmB,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;QACjE,MAAM,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC;QAClC,MAAM,SAAS,GAAG,OAAO,CAAC,KAAK,CAAC;QAChC,MAAM,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC;QAClC,KAAK,MAAM,QAAQ,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC;YACrC,gBAAgB,CACd,QAAQ,EACR,YAAY,CACV,mBAAmB,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,OAAO,KAAK,QAAQ,CAAC,EACjE,KAAK,CAAC,OAAO,CACd,CACF,CAAC;QACJ,CAAC;QACD,KAAK,MAAM,EAAE,IAAI,IAAI,GAAG,CAAC,KAAK,CAAC,WAAW,CAAC,EAAE,CAAC;YAC5C,MAAM,QAAQ,GAAG,gBAAgB,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC;YAChD,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;YACxB,gBAAgB,CAAC,GAAG,CAAC,EAAE,EAAE,QAAQ,CAAC,CAAC;QACrC,CAAC;QACD,MAAM,eAAe,GAAG,KAAK,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;QAC3E,MAAM,kBAAkB,GAAG,WAAW,CAAC,IAAI,CACzC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,qBAAqB,CAAC,KAAK,EAAE,KAAK,CAAC,OAAO,CAAC,CACxD,CAAC;QACF,MAAM,oBAAoB,GACxB,KAAK,CAAC,SAAS,KAAK,SAAS;YAC7B,KAAK,CAAC,KAAK,KAAK,SAAS;YACzB,KAAK,CAAC,UAAU,KAAK,UAAU;YAC/B,KAAK,CAAC,MAAM,KAAK,UAAU;YAC3B,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,UAAU,GAAG,UAAU,CAAC,IAAI,sBAAsB;YACjE,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,GAAG,UAAU,CAAC,IAAI,sBAAsB;YAC7D,KAAK,CAAC,UAAU,KAAK,mBAAmB,CAAC,MAAM,CAAC;QAClD,MAAM,aAAa,GACjB,CAAC,eAAe;YAChB,CAAC,kBAAkB;YACnB,oBAAoB;YACpB,SAAS,IAAI,KAAK,CAAC,cAAc;YACjC,UAAU,IAAI,KAAK,CAAC,cAAc;YAClC,UAAU,IAAI,KAAK,CAAC,eAAe,GAAG,sBAAsB,CAAC;QAC/D,OAAO;YACL,KAAK;YACL,OAAO,EAAE,EAAE,SAAS,EAAE,UAAU,EAAE,UAAU,EAAE;YAC9C,EAAE,EAAE,KAAK,CAAC,EAAE;YACZ,QAAQ,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC,GAAG,GAAG,KAAK,CAAC,KAAK,CAAC;YAC9C,eAAe,EAAE,KAAK,CAAC,eAAe;YACtC,UAAU,EAAE,mBAAmB,CAAC,MAAM;YACtC,SAAS;YACT,UAAU;YACV,UAAU;YACV,cAAc,EAAE,KAAK,CAAC,cAAc;YACpC,aAAa;YACb,eAAe;YACf,kBAAkB;YAClB,oBAAoB;SACrB,CAAC;IACJ,CAAC,CAAC,CAAC;IACH,KAAK,MAAM,CAAC,OAAO,EAAE,QAAQ,CAAC,IAAI,gBAAgB,EAAE,CAAC;QACnD,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC;YAAE,MAAM,CAAC,IAAI,CAAC,4CAA4C,OAAO,EAAE,CAAC,CAAC;IAC9F,CAAC;IACD,KAAK,MAAM,UAAU,IAAI,YAAY,EAAE,CAAC;QACtC,IAAI,UAAU,CAAC,eAAe;YAAE,MAAM,CAAC,IAAI,CAAC,0BAA0B,UAAU,CAAC,EAAE,EAAE,CAAC,CAAC;QACvF,IAAI,UAAU,CAAC,kBAAkB;YAC/B,MAAM,CAAC,IAAI,CAAC,mCAAmC,UAAU,CAAC,EAAE,EAAE,CAAC,CAAC;QAClE,IAAI,CAAC,UAAU,CAAC,oBAAoB;YAAE,MAAM,CAAC,IAAI,CAAC,0BAA0B,UAAU,CAAC,EAAE,EAAE,CAAC,CAAC;IAC/F,CAAC;IACD,MAAM,UAAU,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE,CAAC,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC;IACvF,MAAM,WAAW,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE,CAAC,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC;IACzF,MAAM,WAAW,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE,CAAC,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC;IACzF,IAAI,UAAU,GAAG,KAAK,CAAC,cAAc;QAAE,MAAM,CAAC,IAAI,CAAC,qCAAqC,CAAC,CAAC;IAC1F,IAAI,WAAW,GAAG,KAAK,CAAC,cAAc;QAAE,MAAM,CAAC,IAAI,CAAC,sCAAsC,CAAC,CAAC;IAC5F,IAAI,WAAW,GAAG,KAAK,CAAC,eAAe,GAAG,sBAAsB;QAC9D,MAAM,CAAC,IAAI,CAAC,uCAAuC,CAAC,CAAC;IACvD,KAAK,MAAM,MAAM,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC;QACnC,MAAM,OAAO,GAAG,SAAS,CAAC,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC;QACrF,IAAI,OAAO,CAAC,KAAK,GAAG,MAAM,CAAC,KAAK;YAC9B,MAAM,CAAC,IAAI,CAAC,mCAAmC,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAC;QACpE,IAAI,OAAO,CAAC,MAAM,GAAG,MAAM,CAAC,KAAK;YAC/B,MAAM,CAAC,IAAI,CAAC,oCAAoC,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAC;QACrE,IAAI,OAAO,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,GAAG,sBAAsB;YACzD,MAAM,CAAC,IAAI,CAAC,oCAAoC,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAC;IACvE,CAAC;IACD,MAAM,IAAI,GAAG,MAAM,CAAC,MAAM,KAAK,CAAC,IAAI,YAAY,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC;IACvF,OAAO;QACL,IAAI;QACJ,MAAM,EAAE,IAAI,CAAC,CAAC,CAAC,uBAAuB,CAAC,CAAC,CAAC,yBAAyB;QAClE,WAAW,EAAE;YACX,cAAc,EAAE,KAAK,CAAC,cAAc;YACpC,eAAe,EAAE,KAAK,CAAC,eAAe;YACtC,cAAc,EAAE,KAAK,CAAC,cAAc;YACpC,qBAAqB,EAAE,UAAU,CAAC,MAAM;YACxC,qBAAqB,EAAE,QAAQ,CAAC,MAAM;YACtC,mBAAmB,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,UAAU,CAAC,MAAM,GAAG,WAAW,CAAC,MAAM,CAAC;YACxE,UAAU,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM;YAC/B,eAAe,EAAE,sBAAsB;YACvC,MAAM,EAAE,YAAY,CAAC,GAAG,CACtB,CAAC,EACC,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,QAAQ,EACjB,eAAe,EAAE,QAAQ,EACzB,kBAAkB,EAAE,WAAW,EAC/B,oBAAoB,EAAE,SAAS,EAC/B,GAAG,UAAU,EACd,EAAE,EAAE,CAAC,UAAU,CACjB;SACF;QACD,MAAM,EAAE,CAAC,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,CAAC;KAC7B,CAAC;AACJ,CAAC"}

package/dist/src/review/fun-candidate-generator.d.ts

@@ -0,0 +1,9 @@
+import type { FunCandidate, FunEvent, MatchReviewFacts } from './types.js';
+export declare class FunCandidateGenerator {
+    private readonly limit;
+    constructor(limit?: number);
+    generate(facts: MatchReviewFacts): FunCandidate[];
+    /** V3.3 structured branch; the legacy generate() API remains unchanged. */
+    generateEvents(facts: MatchReviewFacts): FunEvent[];
+}
+export declare function generateFunCandidates(facts: MatchReviewFacts, limit?: number): FunCandidate[];

package/dist/src/review/fun-candidate-generator.js

@@ -0,0 +1,267 @@
+import { generateBaseFunEvents } from './fun-event-generator.js';
+const SUMMARY_EVIDENCE_PREFIX = 'match-summary-';
+const RIDE_THRESHOLD_METERS = 1_000;
+function integer(value) {
+    return Math.round(value).toLocaleString('zh-CN');
+}
+function kilometers(value) {
+    return `${(value / 1_000).toFixed(1)}km`;
+}
+function playerName(facts, playerId) {
+    return facts.players.find((player) => player.playerId === playerId)?.playerName ?? playerId;
+}
+function summaryEvidence(facts) {
+    return `${SUMMARY_EVIDENCE_PREFIX}${facts.match.matchId}`;
+}
+/** Convert internal event/derived references into durable ReviewEvidence IDs. */
+function evidenceReferences(facts, ids) {
+    const available = new Map(facts.evidence.map((item) => [item.id, item]));
+    const byEventId = new Map();
+    for (const evidence of facts.evidence) {
+        for (const eventId of evidence.eventIds) {
+            const references = byEventId.get(eventId) ?? [];
+            references.push(evidence.id);
+            byEventId.set(eventId, references);
+        }
+    }
+    const resolved = [];
+    for (const id of ids) {
+        if (available.has(id)) {
+            resolved.push(id);
+            continue;
+        }
+        const eventEvidenceId = `evidence-${id}`;
+        if (available.has(eventEvidenceId)) {
+            resolved.push(eventEvidenceId);
+            continue;
+        }
+        resolved.push(...(byEventId.get(id) ?? []));
+    }
+    return [...new Set(resolved)];
+}
+function playerEvidence(facts, player, extra = []) {
+    const evidence = [
+        summaryEvidence(facts),
+        ...(player ? [`player-summary-${facts.match.matchId}-${player.playerId}`] : []),
+        ...(player?.keyOperations.flatMap((operation) => operation.evidenceIds) ?? []),
+        ...(player && facts.fightIntegrity.pass
+            ? facts.fights
+                .filter((fight) => fight.keyPlayers.includes(player.playerId))
+                .flatMap((fight) => fight.evidenceIds)
+            : []),
+        ...(player?.vehicle?.evidenceIds ?? []),
+        ...(player?.heavyWeapons.flatMap((weapon) => weapon.evidenceIds) ?? []),
+        ...extra,
+    ];
+    return evidenceReferences(facts, evidence);
+}
+function candidate(id, type, title, text, impactScore, facts, evidenceIds, playerId) {
+    const evidence = [...new Set(evidenceIds)].filter(Boolean);
+    if (!evidence.length)
+        return null;
+    return {
+        id,
+        type,
+        title,
+        text,
+        impactScore,
+        facts,
+        evidenceIds: evidence,
+        ...(playerId ? { playerId } : {}),
+    };
+}
+function specialCandidate(facts, event) {
+    if (!event.playerId)
+        return null;
+    const name = playerName(facts, event.playerId);
+    const values = event.facts;
+    const pickupEvents = Number(values.pickupEvents ?? 0);
+    const shots = Number(values.shots ?? 0);
+    const hits = Number(values.hits ?? 0);
+    const kills = Number(values.kills ?? 0);
+    const typeMap = {
+        ROCKET_UNUSED: {
+            type: 'ROCKET_UNUSED',
+            title: '🎒 军火收藏家',
+            text: `${name}\n火箭筒拾取${pickupEvents}次 · 发射0`,
+            score: 420,
+        },
+        ROCKET_MISS: {
+            type: 'ROCKET_MISS',
+            title: '🎯 火箭筒放空',
+            text: `${name}\n火箭筒发射${shots}次 · 未检测到命中`,
+            score: 330,
+        },
+        ROCKET_MULTI_KILL: {
+            type: 'ROCKET_MULTI_KILL',
+            title: '💥 一炮多响',
+            text: `${name}\n一发火箭筒关联${kills}次击杀`,
+            score: 760 + kills * 40,
+        },
+        ROCKET_VEHICLE_MULTI_KILL: {
+            type: 'ROCKET_VEHICLE_MULTI_KILL',
+            title: `☢️ 一炮${kills}响`,
+            text: `${name}\nPanzerfaust摧毁载具 · ${kills}杀`,
+            score: 1_000 + kills * 60,
+        },
+        ROCKET_HIT: {
+            type: 'SPECIAL_EVENT',
+            title: '🚀 火箭筒开张',
+            text: `${name}\n火箭筒${shots}发 · ${hits}次命中记录`,
+            score: 480 + hits * 30,
+        },
+        MULTI_KNOCK: {
+            type: 'SPECIAL_EVENT',
+            title: '⚡ 倒地制造机',
+            text: `${name}\n一波团战造成${Number(values.knocks ?? 0)}次倒地`,
+            score: 520,
+        },
+        CLUTCH: {
+            type: 'SPECIAL_EVENT',
+            title: '🏆 收割现场',
+            text: `${name}\n团战内完成${kills}次击杀`,
+            score: 580,
+        },
+        REVIVE_CHAIN: {
+            type: 'SPECIAL_EVENT',
+            title: '❤️ 急救站站长',
+            text: `${name}\n连续完成${Number(values.revives ?? 0)}次救援`,
+            score: 360,
+        },
+        VEHICLE_DESTROY: {
+            type: 'SPECIAL_EVENT',
+            title: '🚙 车库拆迁队',
+            text: `${name}\n摧毁${Number(values.vehiclesDestroyed ?? 0)}辆载具`,
+            score: 520,
+        },
+    };
+    const descriptor = typeMap[event.type];
+    if (!descriptor)
+        return null;
+    return candidate(`fun-${event.id}`, descriptor.type, descriptor.title, `${descriptor.title}\n${descriptor.text}`, Math.max(descriptor.score, event.impactScore), event.facts, evidenceReferences(facts, event.evidenceIds), event.playerId);
+}
+function vehicleCandidates(facts) {
+    const vehicles = facts.vehicles.filter((vehicle) => vehicle.evidenceIds.length > 0);
+    const result = [];
+    const drivers = vehicles.filter((vehicle) => vehicle.driverConfirmed && vehicle.driveDistance > 0);
+    const topDriver = [...drivers].sort((left, right) => right.driveDistance - left.driveDistance || left.playerId.localeCompare(right.playerId))[0];
+    if (topDriver) {
+        const player = facts.players.find((item) => item.playerId === topDriver.playerId);
+        const item = candidate(`fun-top-driver-${topDriver.playerId}`, 'TOP_DRIVER', '🚗 车队车神', `🚗 车队车神\n${player?.playerName ?? topDriver.playerId}\n驾驶${kilometers(topDriver.driveDistance)} · 最高${Math.round(topDriver.maxSpeed)}km/h`, 500 + Math.min(280, topDriver.driveDistance / 100), {
+            driveDistance: Math.round(topDriver.driveDistance),
+            maxSpeed: Math.round(topDriver.maxSpeed),
+        }, playerEvidence(facts, player ?? null, topDriver.evidenceIds), topDriver.playerId);
+        if (item)
+            result.push(item);
+    }
+    const passengers = vehicles.filter((vehicle) => vehicle.passengerConfirmed && vehicle.rideDistance > 0);
+    const topPassenger = [...passengers].sort((left, right) => right.rideDistance - left.rideDistance || left.playerId.localeCompare(right.playerId))[0];
+    if (topPassenger) {
+        const player = facts.players.find((item) => item.playerId === topPassenger.playerId);
+        const item = candidate(`fun-top-passenger-${topPassenger.playerId}`, 'TOP_PASSENGER', '🚕 尊贵乘客', `🚕 尊贵乘客\n${player?.playerName ?? topPassenger.playerId}\n乘车${kilometers(topPassenger.rideDistance)}`, 420 + Math.min(220, topPassenger.rideDistance / 100), {
+            rideDistance: Math.round(topPassenger.rideDistance),
+            driveDistance: Math.round(topPassenger.driveDistance),
+            passengerConfirmed: true,
+        }, playerEvidence(facts, player ?? null, topPassenger.evidenceIds), topPassenger.playerId);
+        if (item)
+            result.push(item);
+    }
+    const longest = [...vehicles]
+        .filter((vehicle) => vehicle.rideDistance >= RIDE_THRESHOLD_METERS)
+        .sort((left, right) => right.rideDistance - left.rideDistance || left.playerId.localeCompare(right.playerId))[0];
+    if (longest) {
+        const player = facts.players.find((item) => item.playerId === longest.playerId);
+        const item = candidate(`fun-longest-ride-${longest.playerId}`, 'LONGEST_RIDE', '🛣️ 公路旅行家', `🛣️ 公路旅行家\n${player?.playerName ?? longest.playerId}\n乘车${kilometers(longest.rideDistance)}`, 300 + Math.min(180, longest.rideDistance / 200), { rideDistance: Math.round(longest.rideDistance) }, playerEvidence(facts, player ?? null, longest.evidenceIds), longest.playerId);
+        if (item)
+            result.push(item);
+    }
+    return result;
+}
+function playerCandidates(facts) {
+    const result = [];
+    const players = facts.players.filter((player) => player.matchPresence !== 'not_recorded');
+    const teamDamage = facts.squad.damage;
+    const topDamage = [...players].sort((left, right) => right.damage - left.damage || left.playerId.localeCompare(right.playerId))[0];
+    if (topDamage && topDamage.damage >= Math.max(300, teamDamage * 0.4)) {
+        const item = candidate(`fun-high-damage-${topDamage.playerId}`, 'HIGH_DAMAGE', '💥 火力压制', `💥 火力压制\n${topDamage.playerName}\n${integer(topDamage.damage)}伤害`, 380 + Math.min(260, topDamage.damage / 4), { damage: Math.round(topDamage.damage) }, playerEvidence(facts, topDamage), topDamage.playerId);
+        if (item)
+            result.push(item);
+    }
+    const lowestDamage = [...players]
+        .filter((player) => player.damage > 0 &&
+        teamDamage >= 300 &&
+        player.damage <= teamDamage * 0.12 &&
+        !(player.kills === 0 && player.assists === 0 && player.dbnos === 0 && player.revives === 0))
+        .sort((left, right) => left.damage - right.damage || left.playerId.localeCompare(right.playerId))[0];
+    if (lowestDamage) {
+        const item = candidate(`fun-low-damage-${lowestDamage.playerId}`, 'LOW_DAMAGE', '🫥 输出掉线', `🫥 输出掉线\n${lowestDamage.playerName}\n${integer(lowestDamage.damage)}伤害`, 250 + Math.max(0, 120 - lowestDamage.damage / 4), { damage: Math.round(lowestDamage.damage) }, playerEvidence(facts, lowestDamage), lowestDamage.playerId);
+        if (item)
+            result.push(item);
+    }
+    const knockCandidates = players
+        .filter((player) => player.dbnos >= 3 && player.kills / player.dbnos <= 0.4)
+        .sort((left, right) => right.dbnos - left.dbnos ||
+        left.kills - right.kills ||
+        left.playerId.localeCompare(right.playerId));
+    const knockPlayer = knockCandidates[0];
+    if (knockPlayer) {
+        const item = candidate(`fun-knock-conversion-${knockPlayer.playerId}`, 'HIGH_KNOCK_LOW_CONVERSION', '🫠 白打王', `🫠 白打王\n${knockPlayer.playerName}\n${knockPlayer.dbnos}倒地 · ${knockPlayer.kills}杀`, 430 + knockPlayer.dbnos * 30, { dbnos: knockPlayer.dbnos, kills: knockPlayer.kills }, playerEvidence(facts, knockPlayer), knockPlayer.playerId);
+        if (item)
+            result.push(item);
+    }
+    const noCombat = players
+        .filter((player) => player.kills === 0 &&
+        player.assists === 0 &&
+        player.dbnos === 0 &&
+        player.revives === 0 &&
+        player.damage === 0 &&
+        player.keyOperations.length === 0)
+        .sort((left, right) => left.playerId.localeCompare(right.playerId))[0];
+    if (noCombat) {
+        const item = candidate(`fun-no-combat-${noCombat.playerId}`, 'NO_COMBAT_PRESENCE', '👻 全场隐身', `👻 全场隐身\n${noCombat.playerName}\n0杀 · 0助 · 0倒地 · 0救援 · 0伤害`, 410, { kills: 0, assists: 0, dbnos: 0, revives: 0, damage: 0 }, playerEvidence(facts, noCombat), noCombat.playerId);
+        if (item)
+            result.push(item);
+    }
+    const topRevives = [...players].sort((left, right) => right.revives - left.revives || left.playerId.localeCompare(right.playerId))[0];
+    if (topRevives && topRevives.revives >= 2) {
+        const item = candidate(`fun-most-revives-${topRevives.playerId}`, 'MOST_REVIVES', '❤️ 移动急救站', `❤️ 移动急救站\n${topRevives.playerName}\n${topRevives.revives}救援`, 350 + topRevives.revives * 40, { revives: topRevives.revives }, playerEvidence(facts, topRevives), topRevives.playerId);
+        if (item)
+            result.push(item);
+    }
+    const topAssists = [...players].sort((left, right) => right.assists - left.assists || left.playerId.localeCompare(right.playerId))[0];
+    const secondAssists = [...players].sort((left, right) => right.assists - left.assists || left.playerId.localeCompare(right.playerId))[1];
+    if (topAssists && topAssists.assists >= 2 && topAssists.assists > (secondAssists?.assists ?? 0)) {
+        const item = candidate(`fun-most-assists-${topAssists.playerId}`, 'MOST_ASSISTS', '🤝 助攻发动机', `🤝 助攻发动机\n${topAssists.playerName}\n${topAssists.assists}助攻`, 330 + topAssists.assists * 35, { assists: topAssists.assists }, playerEvidence(facts, topAssists), topAssists.playerId);
+        if (item)
+            result.push(item);
+    }
+    return result;
+}
+function sortCandidates(left, right) {
+    return (right.impactScore - left.impactScore ||
+        left.type.localeCompare(right.type) ||
+        (left.playerId ?? '').localeCompare(right.playerId ?? '') ||
+        left.id.localeCompare(right.id));
+}
+export class FunCandidateGenerator {
+    limit;
+    constructor(limit = 5) {
+        this.limit = limit;
+    }
+    generate(facts) {
+        const candidates = [
+            ...facts.specialEvents.map((event) => specialCandidate(facts, event)),
+            ...vehicleCandidates(facts),
+            ...playerCandidates(facts),
+        ].filter((item) => item !== null && item.evidenceIds.length > 0);
+        return candidates.sort(sortCandidates).slice(0, Math.max(0, this.limit));
+    }
+    /** V3.3 structured branch; the legacy generate() API remains unchanged. */
+    generateEvents(facts) {
+        return generateBaseFunEvents(facts);
+    }
+}
+export function generateFunCandidates(facts, limit = 5) {
+    return new FunCandidateGenerator(limit).generate(facts);
+}
+//# sourceMappingURL=fun-candidate-generator.js.map

package/dist/src/review/fun-candidate-generator.js.map

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

package/dist/src/review/fun-event-generator.d.ts

@@ -0,0 +1,8 @@
+import type { FunEvent, MatchReviewFacts } from './types.js';
+/** Turn raw event IDs and derived fact IDs into IDs present in ReviewEvidence. */
+export declare function resolveFunEvidenceIds(facts: MatchReviewFacts, ids: string[]): string[];
+/** Generate one structured event per reliable fact pattern; combos are added later. */
+export declare function generateBaseFunEvents(facts: MatchReviewFacts): FunEvent[];
+export declare class FunEventCandidateGenerator {
+    generate(facts: MatchReviewFacts): FunEvent[];
+}