volleyballsimtypes 0.0.422 → 0.0.424

package/dist/cjs/src/api/index.d.ts

@@ -1,4 +1,4 @@
-import { BoxScore, DataProps, DeclineStatus, Division as _Division, League as _League, Match as _Match, MatchSet as _MatchSet, Player as _Player, PlayerPosition, Qualifier as _Qualifier, QualifierMatch as _QualifierMatch, Rally as _Rally, RallyEvent as _RallyEvent, Season as _Season, Standing as _Standing, Team as _Team, Tournament as _Tournament, TournamentMatch as _TournamentMatch, National as _National, NationalMatch as _NationalMatch, Country as _Country, CourtPosition, ConditionLogic, EnergyBand, LiberoSubMode, PerformanceStats, PinchCondition, RotationSystemEnum, SubBand, SubMode } from '../service';
+import { BoxScore, DataProps, DeclineStatus, Division as _Division, League as _League, Match as _Match, MatchSet as _MatchSet, Player as _Player, PlayerPosition, Qualifier as _Qualifier, QualifierMatch as _QualifierMatch, Rally as _Rally, RallyEvent as _RallyEvent, RallyMetrics, Season as _Season, Standing as _Standing, Team as _Team, Tournament as _Tournament, TournamentMatch as _TournamentMatch, National as _National, NationalMatch as _NationalMatch, Country as _Country, CourtPosition, ConditionLogic, EnergyBand, LiberoSubMode, PerformanceStats, PinchCondition, RotationSystemEnum, SubBand, SubMode } from '../service';
 export type Rally = DataProps<_Rally> & {
     homePlayerPosition: PlayerPosition[];
     awayPlayerPosition: PlayerPosition[];
@@ -36,6 +36,7 @@ export type Match = Omit<DataProps<_Match>, 'sets' | 'homeTeam' | 'awayTeam' | '
     national?: National;
     results?: Results;
     competition?: MatchCompetition;
+    rallyMetrics?: RallyMetrics;
 };
 export type RallyEvent = DataProps<_RallyEvent> & {
     team?: Team;

package/dist/cjs/src/service/match/index.d.ts

@@ -5,6 +5,7 @@ export * from './match-rating';
 export * from './match-set';
 export * from './rally';
 export * from './point-breakdown';
+export * from './rally-metrics';
 export * from './court-position';
 export * from './match-team';
 export * from './vper';

package/dist/cjs/src/service/match/index.js

@@ -21,6 +21,7 @@ __exportStar(require("./match-rating"), exports);
 __exportStar(require("./match-set"), exports);
 __exportStar(require("./rally"), exports);
 __exportStar(require("./point-breakdown"), exports);
+__exportStar(require("./rally-metrics"), exports);
 __exportStar(require("./court-position"), exports);
 __exportStar(require("./match-team"), exports);
 __exportStar(require("./vper"), exports);

package/dist/cjs/src/service/match/rally-metrics.d.ts

@@ -0,0 +1,47 @@
+export interface RallyMetricsEvent {
+    readonly eventType: number;
+    readonly failure?: number;
+}
+export interface RallyMetricsRally {
+    readonly servingTeamId: string;
+    readonly events: readonly RallyMetricsEvent[];
+}
+export interface RallyMetricsSet {
+    readonly rallies: readonly RallyMetricsRally[];
+    readonly homePoints: number;
+    readonly awayPoints: number;
+    readonly homeSetterStartZone: number | null;
+    readonly awaySetterStartZone: number | null;
+}
+export interface RotationMetrics {
+    setterZone: number | null;
+    rotation: number;
+    servePoints: number;
+    sideoutPoints: number;
+    points: number;
+}
+export interface TeamRallyMetrics {
+    serves: number;
+    breakpointWins: number;
+    breakpointPct: number;
+    receptions: number;
+    sideoutWins: number;
+    sideoutPct: number;
+    serviceErrorsReceived: number;
+    modReceptions: number;
+    modSideoutWins: number;
+    modSideoutPct: number;
+    fbsoWins: number;
+    fbsoPct: number;
+    modFbsoPct: number;
+    rotations: RotationMetrics[];
+}
+export interface SetRallyMetrics {
+    home: TeamRallyMetrics;
+    away: TeamRallyMetrics;
+}
+export interface RallyMetrics {
+    total: SetRallyMetrics;
+    sets: SetRallyMetrics[];
+}
+export declare function computeRallyMetrics(sets: readonly RallyMetricsSet[], homeTeamId: string, awayTeamId: string): RallyMetrics;

package/dist/cjs/src/service/match/rally-metrics.js

@@ -0,0 +1,115 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.computeRallyMetrics = computeRallyMetrics;
+const event_1 = require("../event");
+const court_position_1 = require("./court-position");
+function newAcc() {
+    return { serves: 0, breakpointWins: 0, receptions: 0, sideoutWins: 0, serviceErrorsReceived: 0, fbsoWins: 0, rotations: new Map() };
+}
+function isServiceError(rally) {
+    const serve = rally.events.find(e => e.eventType === event_1.EventTypeEnum.SERVE);
+    return serve != null && (serve.failure ?? 0) > 0;
+}
+// A first-ball sideout is won on the receiving team's first attack: the rally has exactly one spike (the
+// engine scores a second spike as a transition). This counts first-ball kills and the block errors forced
+// on that first attack, and excludes service-error sideouts (no spike) and dig-and-transition rallies (2+).
+function spikeCount(rally) {
+    return rally.events.reduce((n, e) => e.eventType === event_1.EventTypeEnum.SPIKE ? n + 1 : n, 0);
+}
+// The setter's zone after (rotationIndex - 1) rotations from their start zone, using the engine's own
+// rotatePosition (each rotation moves a player one zone: 2->1, 1->6, ...). null when no setter.
+function setterZoneAt(startZone, rotationIndex) {
+    if (startZone == null)
+        return null;
+    let zone = startZone;
+    for (let r = 1; r < rotationIndex; r++)
+        zone = (0, court_position_1.rotatePosition)(zone);
+    return zone;
+}
+function addRotationPoint(acc, setterZone, rotation, kind) {
+    const key = setterZone != null ? `z${setterZone}` : `r${rotation}`;
+    let entry = acc.rotations.get(key);
+    if (entry == null) {
+        entry = { setterZone, rotation, servePoints: 0, sideoutPoints: 0 };
+        acc.rotations.set(key, entry);
+    }
+    if (kind === 'serve')
+        entry.servePoints++;
+    else
+        entry.sideoutPoints++;
+}
+// Walk one set, folding its rallies into the home/away accumulators (used for both per-set and total).
+function accumulateSet(set, homeId, awayId, homeAcc, awayAcc) {
+    const { rallies } = set;
+    if (rallies.length === 0)
+        return;
+    const setWinnerId = set.homePoints > set.awayPoints ? homeId : awayId;
+    const rotation = { [homeId]: 1, [awayId]: 1 };
+    const startZone = { [homeId]: set.homeSetterStartZone, [awayId]: set.awaySetterStartZone };
+    const accOf = (id) => id === homeId ? homeAcc : id === awayId ? awayAcc : null;
+    for (let i = 0; i < rallies.length; i++) {
+        const servingId = rallies[i].servingTeamId;
+        const receivingId = servingId === homeId ? awayId : homeId;
+        const winnerId = i < rallies.length - 1 ? rallies[i + 1].servingTeamId : setWinnerId;
+        const serving = accOf(servingId);
+        const receiving = accOf(receivingId);
+        const winner = accOf(winnerId);
+        if (serving == null || receiving == null || winner == null)
+            continue;
+        serving.serves++;
+        receiving.receptions++;
+        if (isServiceError(rallies[i]))
+            receiving.serviceErrorsReceived++;
+        const rotIdx = rotation[winnerId];
+        const zone = setterZoneAt(startZone[winnerId], rotIdx);
+        if (winnerId === servingId) {
+            serving.breakpointWins++;
+            addRotationPoint(winner, zone, rotIdx, 'serve');
+        }
+        else {
+            receiving.sideoutWins++;
+            if (spikeCount(rallies[i]) === 1)
+                receiving.fbsoWins++;
+            addRotationPoint(winner, zone, rotIdx, 'sideout');
+        }
+        // The sideout winner gains serve, so they rotate (after the point is attributed to their old rotation).
+        if (winnerId === receivingId)
+            rotation[winnerId] = (rotation[winnerId] % 6) + 1;
+    }
+}
+function finalizeTeam(acc) {
+    const modReceptions = acc.receptions - acc.serviceErrorsReceived;
+    const modSideoutWins = acc.sideoutWins - acc.serviceErrorsReceived;
+    const rotations = [...acc.rotations.values()]
+        .map(e => ({ ...e, points: e.servePoints + e.sideoutPoints }))
+        .sort((a, b) => (a.setterZone ?? a.rotation) - (b.setterZone ?? b.rotation));
+    return {
+        serves: acc.serves,
+        breakpointWins: acc.breakpointWins,
+        breakpointPct: acc.serves > 0 ? (acc.breakpointWins / acc.serves) * 100 : 0,
+        receptions: acc.receptions,
+        sideoutWins: acc.sideoutWins,
+        sideoutPct: acc.receptions > 0 ? (acc.sideoutWins / acc.receptions) * 100 : 0,
+        serviceErrorsReceived: acc.serviceErrorsReceived,
+        modReceptions,
+        modSideoutWins,
+        modSideoutPct: modReceptions > 0 ? (modSideoutWins / modReceptions) * 100 : 0,
+        fbsoWins: acc.fbsoWins,
+        fbsoPct: acc.receptions > 0 ? (acc.fbsoWins / acc.receptions) * 100 : 0,
+        modFbsoPct: modReceptions > 0 ? (acc.fbsoWins / modReceptions) * 100 : 0,
+        rotations
+    };
+}
+function computeRallyMetrics(sets, homeTeamId, awayTeamId) {
+    const totalHome = newAcc();
+    const totalAway = newAcc();
+    const setResults = [];
+    for (const set of sets) {
+        const setHome = newAcc();
+        const setAway = newAcc();
+        accumulateSet(set, homeTeamId, awayTeamId, setHome, setAway);
+        accumulateSet(set, homeTeamId, awayTeamId, totalHome, totalAway);
+        setResults.push({ home: finalizeTeam(setHome), away: finalizeTeam(setAway) });
+    }
+    return { total: { home: finalizeTeam(totalHome), away: finalizeTeam(totalAway) }, sets: setResults };
+}

package/dist/cjs/src/service/match/rally-metrics.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/cjs/src/service/match/rally-metrics.test.js

@@ -0,0 +1,92 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const rally_metrics_1 = require("./rally-metrics");
+const event_1 = require("../event");
+const serve = (failure = 0) => ({
+    events: [{ eventType: event_1.EventTypeEnum.SERVE, failure }]
+});
+const HOME = 'H';
+const AWAY = 'A';
+// Serving sequence H, H, A, A, H. Rally 1 (H's serve) is a service error. Final H 3 - 2 A resolves the
+// last rally -> H. Winners: H, A, A, H, H. Home setter starts in zone 2, away setter in zone 1.
+const set = {
+    homePoints: 3,
+    awayPoints: 2,
+    homeSetterStartZone: 2,
+    awaySetterStartZone: 1,
+    rallies: [
+        { servingTeamId: HOME, ...serve() }, // 0: H breakpoint, H setter z2
+        { servingTeamId: HOME, ...serve(1) }, // 1: A sideout via H service error, A setter z1
+        { servingTeamId: AWAY, ...serve() }, // 2: A breakpoint, A rotated to z6
+        { servingTeamId: AWAY, ...serve() }, // 3: H sideout, H still z2
+        { servingTeamId: HOME, ...serve() } // 4: H breakpoint, H rotated to z1
+    ]
+};
+const m = (0, rally_metrics_1.computeRallyMetrics)([set], HOME, AWAY);
+describe('computeRallyMetrics()', () => {
+    it('serve / sideout / breakpoint counts and percentages', () => {
+        expect(m.total.home.serves).toBe(3);
+        expect(m.total.home.breakpointWins).toBe(2);
+        expect(m.total.home.breakpointPct).toBeCloseTo(66.6667, 3);
+        expect(m.total.home.receptions).toBe(2);
+        expect(m.total.home.sideoutWins).toBe(1);
+        expect(m.total.home.sideoutPct).toBeCloseTo(50, 5);
+        expect(m.total.away.serves).toBe(2);
+        expect(m.total.away.breakpointWins).toBe(1);
+        expect(m.total.away.receptions).toBe(3);
+        expect(m.total.away.sideoutWins).toBe(1);
+        expect(m.total.away.sideoutPct).toBeCloseTo(33.3333, 3);
+    });
+    it('modified sideout excludes the opponent service error', () => {
+        expect(m.total.away.serviceErrorsReceived).toBe(1);
+        expect(m.total.away.modReceptions).toBe(2);
+        expect(m.total.away.modSideoutWins).toBe(0);
+        expect(m.total.away.modSideoutPct).toBe(0);
+        expect(m.total.home.serviceErrorsReceived).toBe(0);
+        expect(m.total.home.modSideoutPct).toBeCloseTo(50, 5);
+    });
+    it('per-set rotations labeled by setter zone, split serve vs sideout', () => {
+        expect(m.sets).toHaveLength(1);
+        expect(m.sets[0].home.rotations).toEqual([
+            { setterZone: 1, rotation: 2, servePoints: 1, sideoutPoints: 0, points: 1 },
+            { setterZone: 2, rotation: 1, servePoints: 1, sideoutPoints: 1, points: 2 }
+        ]);
+        expect(m.sets[0].away.rotations).toEqual([
+            { setterZone: 1, rotation: 1, servePoints: 0, sideoutPoints: 1, points: 1 },
+            { setterZone: 6, rotation: 2, servePoints: 1, sideoutPoints: 0, points: 1 }
+        ]);
+    });
+});
+// First ball sideout: a sideout won on the receiving team's first attack (exactly one spike in the rally).
+const serveEv = (failure = 0) => ({ eventType: event_1.EventTypeEnum.SERVE, failure });
+const spikeEv = () => ({ eventType: event_1.EventTypeEnum.SPIKE, failure: 0 });
+// serving H, A, H, A ; winners A, H, A, A (A 3 - H 1). Setter-agnostic, so no setters.
+const fbsoSet = {
+    homePoints: 1,
+    awayPoints: 3,
+    homeSetterStartZone: null,
+    awaySetterStartZone: null,
+    rallies: [
+        { servingTeamId: HOME, events: [serveEv(), spikeEv()] }, // A sideout on 1 spike -> A FBSO
+        { servingTeamId: AWAY, events: [serveEv(), spikeEv(), spikeEv()] }, // H sideout on 2 spikes -> transition, not FBSO
+        { servingTeamId: HOME, events: [serveEv(1)] }, // A sideout via H service error, 0 spikes -> not FBSO
+        { servingTeamId: AWAY, events: [serveEv(), spikeEv()] } // A breakpoint (A serving) -> not a reception win
+    ]
+};
+const fm = (0, rally_metrics_1.computeRallyMetrics)([fbsoSet], HOME, AWAY);
+describe('computeRallyMetrics() first ball sideout', () => {
+    it('counts only sideouts won on the first attack (one spike)', () => {
+        expect(fm.total.away.receptions).toBe(2);
+        expect(fm.total.away.fbsoWins).toBe(1);
+        expect(fm.total.away.fbsoPct).toBeCloseTo(50, 5);
+    });
+    it('modified FBSO excludes opponent service errors from the denominator', () => {
+        expect(fm.total.away.serviceErrorsReceived).toBe(1);
+        expect(fm.total.away.modFbsoPct).toBeCloseTo(100, 5);
+    });
+    it('ignores transition sideouts (2+ spikes) and reception losses', () => {
+        expect(fm.total.home.fbsoWins).toBe(0);
+        expect(fm.total.home.fbsoPct).toBe(0);
+        expect(fm.total.home.modFbsoPct).toBe(0);
+    });
+});

package/dist/esm/src/api/index.d.ts

@@ -1,4 +1,4 @@
-import { BoxScore, DataProps, DeclineStatus, Division as _Division, League as _League, Match as _Match, MatchSet as _MatchSet, Player as _Player, PlayerPosition, Qualifier as _Qualifier, QualifierMatch as _QualifierMatch, Rally as _Rally, RallyEvent as _RallyEvent, Season as _Season, Standing as _Standing, Team as _Team, Tournament as _Tournament, TournamentMatch as _TournamentMatch, National as _National, NationalMatch as _NationalMatch, Country as _Country, CourtPosition, ConditionLogic, EnergyBand, LiberoSubMode, PerformanceStats, PinchCondition, RotationSystemEnum, SubBand, SubMode } from '../service';
+import { BoxScore, DataProps, DeclineStatus, Division as _Division, League as _League, Match as _Match, MatchSet as _MatchSet, Player as _Player, PlayerPosition, Qualifier as _Qualifier, QualifierMatch as _QualifierMatch, Rally as _Rally, RallyEvent as _RallyEvent, RallyMetrics, Season as _Season, Standing as _Standing, Team as _Team, Tournament as _Tournament, TournamentMatch as _TournamentMatch, National as _National, NationalMatch as _NationalMatch, Country as _Country, CourtPosition, ConditionLogic, EnergyBand, LiberoSubMode, PerformanceStats, PinchCondition, RotationSystemEnum, SubBand, SubMode } from '../service';
 export type Rally = DataProps<_Rally> & {
     homePlayerPosition: PlayerPosition[];
     awayPlayerPosition: PlayerPosition[];
@@ -36,6 +36,7 @@ export type Match = Omit<DataProps<_Match>, 'sets' | 'homeTeam' | 'awayTeam' | '
     national?: National;
     results?: Results;
     competition?: MatchCompetition;
+    rallyMetrics?: RallyMetrics;
 };
 export type RallyEvent = DataProps<_RallyEvent> & {
     team?: Team;

package/dist/esm/src/service/match/index.d.ts

@@ -5,6 +5,7 @@ export * from './match-rating';
 export * from './match-set';
 export * from './rally';
 export * from './point-breakdown';
+export * from './rally-metrics';
 export * from './court-position';
 export * from './match-team';
 export * from './vper';

package/dist/esm/src/service/match/index.js

@@ -5,6 +5,7 @@ export * from './match-rating';
 export * from './match-set';
 export * from './rally';
 export * from './point-breakdown';
+export * from './rally-metrics';
 export * from './court-position';
 export * from './match-team';
 export * from './vper';

package/dist/esm/src/service/match/rally-metrics.d.ts

@@ -0,0 +1,47 @@
+export interface RallyMetricsEvent {
+    readonly eventType: number;
+    readonly failure?: number;
+}
+export interface RallyMetricsRally {
+    readonly servingTeamId: string;
+    readonly events: readonly RallyMetricsEvent[];
+}
+export interface RallyMetricsSet {
+    readonly rallies: readonly RallyMetricsRally[];
+    readonly homePoints: number;
+    readonly awayPoints: number;
+    readonly homeSetterStartZone: number | null;
+    readonly awaySetterStartZone: number | null;
+}
+export interface RotationMetrics {
+    setterZone: number | null;
+    rotation: number;
+    servePoints: number;
+    sideoutPoints: number;
+    points: number;
+}
+export interface TeamRallyMetrics {
+    serves: number;
+    breakpointWins: number;
+    breakpointPct: number;
+    receptions: number;
+    sideoutWins: number;
+    sideoutPct: number;
+    serviceErrorsReceived: number;
+    modReceptions: number;
+    modSideoutWins: number;
+    modSideoutPct: number;
+    fbsoWins: number;
+    fbsoPct: number;
+    modFbsoPct: number;
+    rotations: RotationMetrics[];
+}
+export interface SetRallyMetrics {
+    home: TeamRallyMetrics;
+    away: TeamRallyMetrics;
+}
+export interface RallyMetrics {
+    total: SetRallyMetrics;
+    sets: SetRallyMetrics[];
+}
+export declare function computeRallyMetrics(sets: readonly RallyMetricsSet[], homeTeamId: string, awayTeamId: string): RallyMetrics;

package/dist/esm/src/service/match/rally-metrics.js

@@ -0,0 +1,112 @@
+import { EventTypeEnum } from '../event';
+import { rotatePosition } from './court-position';
+function newAcc() {
+    return { serves: 0, breakpointWins: 0, receptions: 0, sideoutWins: 0, serviceErrorsReceived: 0, fbsoWins: 0, rotations: new Map() };
+}
+function isServiceError(rally) {
+    const serve = rally.events.find(e => e.eventType === EventTypeEnum.SERVE);
+    return serve != null && (serve.failure ?? 0) > 0;
+}
+// A first-ball sideout is won on the receiving team's first attack: the rally has exactly one spike (the
+// engine scores a second spike as a transition). This counts first-ball kills and the block errors forced
+// on that first attack, and excludes service-error sideouts (no spike) and dig-and-transition rallies (2+).
+function spikeCount(rally) {
+    return rally.events.reduce((n, e) => e.eventType === EventTypeEnum.SPIKE ? n + 1 : n, 0);
+}
+// The setter's zone after (rotationIndex - 1) rotations from their start zone, using the engine's own
+// rotatePosition (each rotation moves a player one zone: 2->1, 1->6, ...). null when no setter.
+function setterZoneAt(startZone, rotationIndex) {
+    if (startZone == null)
+        return null;
+    let zone = startZone;
+    for (let r = 1; r < rotationIndex; r++)
+        zone = rotatePosition(zone);
+    return zone;
+}
+function addRotationPoint(acc, setterZone, rotation, kind) {
+    const key = setterZone != null ? `z${setterZone}` : `r${rotation}`;
+    let entry = acc.rotations.get(key);
+    if (entry == null) {
+        entry = { setterZone, rotation, servePoints: 0, sideoutPoints: 0 };
+        acc.rotations.set(key, entry);
+    }
+    if (kind === 'serve')
+        entry.servePoints++;
+    else
+        entry.sideoutPoints++;
+}
+// Walk one set, folding its rallies into the home/away accumulators (used for both per-set and total).
+function accumulateSet(set, homeId, awayId, homeAcc, awayAcc) {
+    const { rallies } = set;
+    if (rallies.length === 0)
+        return;
+    const setWinnerId = set.homePoints > set.awayPoints ? homeId : awayId;
+    const rotation = { [homeId]: 1, [awayId]: 1 };
+    const startZone = { [homeId]: set.homeSetterStartZone, [awayId]: set.awaySetterStartZone };
+    const accOf = (id) => id === homeId ? homeAcc : id === awayId ? awayAcc : null;
+    for (let i = 0; i < rallies.length; i++) {
+        const servingId = rallies[i].servingTeamId;
+        const receivingId = servingId === homeId ? awayId : homeId;
+        const winnerId = i < rallies.length - 1 ? rallies[i + 1].servingTeamId : setWinnerId;
+        const serving = accOf(servingId);
+        const receiving = accOf(receivingId);
+        const winner = accOf(winnerId);
+        if (serving == null || receiving == null || winner == null)
+            continue;
+        serving.serves++;
+        receiving.receptions++;
+        if (isServiceError(rallies[i]))
+            receiving.serviceErrorsReceived++;
+        const rotIdx = rotation[winnerId];
+        const zone = setterZoneAt(startZone[winnerId], rotIdx);
+        if (winnerId === servingId) {
+            serving.breakpointWins++;
+            addRotationPoint(winner, zone, rotIdx, 'serve');
+        }
+        else {
+            receiving.sideoutWins++;
+            if (spikeCount(rallies[i]) === 1)
+                receiving.fbsoWins++;
+            addRotationPoint(winner, zone, rotIdx, 'sideout');
+        }
+        // The sideout winner gains serve, so they rotate (after the point is attributed to their old rotation).
+        if (winnerId === receivingId)
+            rotation[winnerId] = (rotation[winnerId] % 6) + 1;
+    }
+}
+function finalizeTeam(acc) {
+    const modReceptions = acc.receptions - acc.serviceErrorsReceived;
+    const modSideoutWins = acc.sideoutWins - acc.serviceErrorsReceived;
+    const rotations = [...acc.rotations.values()]
+        .map(e => ({ ...e, points: e.servePoints + e.sideoutPoints }))
+        .sort((a, b) => (a.setterZone ?? a.rotation) - (b.setterZone ?? b.rotation));
+    return {
+        serves: acc.serves,
+        breakpointWins: acc.breakpointWins,
+        breakpointPct: acc.serves > 0 ? (acc.breakpointWins / acc.serves) * 100 : 0,
+        receptions: acc.receptions,
+        sideoutWins: acc.sideoutWins,
+        sideoutPct: acc.receptions > 0 ? (acc.sideoutWins / acc.receptions) * 100 : 0,
+        serviceErrorsReceived: acc.serviceErrorsReceived,
+        modReceptions,
+        modSideoutWins,
+        modSideoutPct: modReceptions > 0 ? (modSideoutWins / modReceptions) * 100 : 0,
+        fbsoWins: acc.fbsoWins,
+        fbsoPct: acc.receptions > 0 ? (acc.fbsoWins / acc.receptions) * 100 : 0,
+        modFbsoPct: modReceptions > 0 ? (acc.fbsoWins / modReceptions) * 100 : 0,
+        rotations
+    };
+}
+export function computeRallyMetrics(sets, homeTeamId, awayTeamId) {
+    const totalHome = newAcc();
+    const totalAway = newAcc();
+    const setResults = [];
+    for (const set of sets) {
+        const setHome = newAcc();
+        const setAway = newAcc();
+        accumulateSet(set, homeTeamId, awayTeamId, setHome, setAway);
+        accumulateSet(set, homeTeamId, awayTeamId, totalHome, totalAway);
+        setResults.push({ home: finalizeTeam(setHome), away: finalizeTeam(setAway) });
+    }
+    return { total: { home: finalizeTeam(totalHome), away: finalizeTeam(totalAway) }, sets: setResults };
+}

package/dist/esm/src/service/match/rally-metrics.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/esm/src/service/match/rally-metrics.test.js

@@ -0,0 +1,90 @@
+import { computeRallyMetrics } from './rally-metrics';
+import { EventTypeEnum } from '../event';
+const serve = (failure = 0) => ({
+    events: [{ eventType: EventTypeEnum.SERVE, failure }]
+});
+const HOME = 'H';
+const AWAY = 'A';
+// Serving sequence H, H, A, A, H. Rally 1 (H's serve) is a service error. Final H 3 - 2 A resolves the
+// last rally -> H. Winners: H, A, A, H, H. Home setter starts in zone 2, away setter in zone 1.
+const set = {
+    homePoints: 3,
+    awayPoints: 2,
+    homeSetterStartZone: 2,
+    awaySetterStartZone: 1,
+    rallies: [
+        { servingTeamId: HOME, ...serve() }, // 0: H breakpoint, H setter z2
+        { servingTeamId: HOME, ...serve(1) }, // 1: A sideout via H service error, A setter z1
+        { servingTeamId: AWAY, ...serve() }, // 2: A breakpoint, A rotated to z6
+        { servingTeamId: AWAY, ...serve() }, // 3: H sideout, H still z2
+        { servingTeamId: HOME, ...serve() } // 4: H breakpoint, H rotated to z1
+    ]
+};
+const m = computeRallyMetrics([set], HOME, AWAY);
+describe('computeRallyMetrics()', () => {
+    it('serve / sideout / breakpoint counts and percentages', () => {
+        expect(m.total.home.serves).toBe(3);
+        expect(m.total.home.breakpointWins).toBe(2);
+        expect(m.total.home.breakpointPct).toBeCloseTo(66.6667, 3);
+        expect(m.total.home.receptions).toBe(2);
+        expect(m.total.home.sideoutWins).toBe(1);
+        expect(m.total.home.sideoutPct).toBeCloseTo(50, 5);
+        expect(m.total.away.serves).toBe(2);
+        expect(m.total.away.breakpointWins).toBe(1);
+        expect(m.total.away.receptions).toBe(3);
+        expect(m.total.away.sideoutWins).toBe(1);
+        expect(m.total.away.sideoutPct).toBeCloseTo(33.3333, 3);
+    });
+    it('modified sideout excludes the opponent service error', () => {
+        expect(m.total.away.serviceErrorsReceived).toBe(1);
+        expect(m.total.away.modReceptions).toBe(2);
+        expect(m.total.away.modSideoutWins).toBe(0);
+        expect(m.total.away.modSideoutPct).toBe(0);
+        expect(m.total.home.serviceErrorsReceived).toBe(0);
+        expect(m.total.home.modSideoutPct).toBeCloseTo(50, 5);
+    });
+    it('per-set rotations labeled by setter zone, split serve vs sideout', () => {
+        expect(m.sets).toHaveLength(1);
+        expect(m.sets[0].home.rotations).toEqual([
+            { setterZone: 1, rotation: 2, servePoints: 1, sideoutPoints: 0, points: 1 },
+            { setterZone: 2, rotation: 1, servePoints: 1, sideoutPoints: 1, points: 2 }
+        ]);
+        expect(m.sets[0].away.rotations).toEqual([
+            { setterZone: 1, rotation: 1, servePoints: 0, sideoutPoints: 1, points: 1 },
+            { setterZone: 6, rotation: 2, servePoints: 1, sideoutPoints: 0, points: 1 }
+        ]);
+    });
+});
+// First ball sideout: a sideout won on the receiving team's first attack (exactly one spike in the rally).
+const serveEv = (failure = 0) => ({ eventType: EventTypeEnum.SERVE, failure });
+const spikeEv = () => ({ eventType: EventTypeEnum.SPIKE, failure: 0 });
+// serving H, A, H, A ; winners A, H, A, A (A 3 - H 1). Setter-agnostic, so no setters.
+const fbsoSet = {
+    homePoints: 1,
+    awayPoints: 3,
+    homeSetterStartZone: null,
+    awaySetterStartZone: null,
+    rallies: [
+        { servingTeamId: HOME, events: [serveEv(), spikeEv()] }, // A sideout on 1 spike -> A FBSO
+        { servingTeamId: AWAY, events: [serveEv(), spikeEv(), spikeEv()] }, // H sideout on 2 spikes -> transition, not FBSO
+        { servingTeamId: HOME, events: [serveEv(1)] }, // A sideout via H service error, 0 spikes -> not FBSO
+        { servingTeamId: AWAY, events: [serveEv(), spikeEv()] } // A breakpoint (A serving) -> not a reception win
+    ]
+};
+const fm = computeRallyMetrics([fbsoSet], HOME, AWAY);
+describe('computeRallyMetrics() first ball sideout', () => {
+    it('counts only sideouts won on the first attack (one spike)', () => {
+        expect(fm.total.away.receptions).toBe(2);
+        expect(fm.total.away.fbsoWins).toBe(1);
+        expect(fm.total.away.fbsoPct).toBeCloseTo(50, 5);
+    });
+    it('modified FBSO excludes opponent service errors from the denominator', () => {
+        expect(fm.total.away.serviceErrorsReceived).toBe(1);
+        expect(fm.total.away.modFbsoPct).toBeCloseTo(100, 5);
+    });
+    it('ignores transition sideouts (2+ spikes) and reception losses', () => {
+        expect(fm.total.home.fbsoWins).toBe(0);
+        expect(fm.total.home.fbsoPct).toBe(0);
+        expect(fm.total.home.modFbsoPct).toBe(0);
+    });
+});

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "volleyballsimtypes",
-  "version": "0.0.422",
+  "version": "0.0.424",
   "description": "vbsim types",
   "main": "./dist/cjs/src/index.js",
   "module": "./dist/esm/src/index.js",