volleyballsimtypes 0.0.356 → 0.0.358

package/dist/esm/src/service/match/box-score.d.ts

@@ -0,0 +1,94 @@
+export interface AttackStats {
+    attempts: number;
+    kills: number;
+    errors: number;
+}
+export interface ServeStats {
+    attempts: number;
+    aces: number;
+    errors: number;
+}
+export interface ReceptionStats {
+    attempts: number;
+    perfect: number;
+    positive: number;
+    overpasses: number;
+    errors: number;
+}
+export interface BlockStats {
+    solo: number;
+    assists: number;
+    errors: number;
+    touches: number;
+}
+export interface SettingStats {
+    assists: number;
+    errors: number;
+    pass: number;
+}
+export interface DefenseStats {
+    digs: number;
+    errors: number;
+}
+/**
+ * Misc stats are about participation and rotation impact.
+ * These are *incredibly* useful for analytics and AI later.
+ */
+export interface MiscStats {
+    /** Number of rallies this player was on the court in this set */
+    pointsPlayed: number;
+    /** Rallies won by the team while this player was on the court in this set */
+    pointsWonOnCourt: number;
+    /** How many distinct serve turns the player had in this set (i.e. times they went back to serve) */
+    serveTurns: number;
+    /** Number of sideout opportunities while the player was on court (optional but handy) */
+    sideoutOpportunities: number;
+    /** Number of successful sideouts while the player was on court (optional but handy) */
+    successfulSideouts: number;
+}
+/**
+ * Per-player, per-set box score row
+ * =================================
+ * This is the fundamental unit you store.
+ */
+export interface BoxScoreParams {
+    playerId: string;
+    matchSetId: string;
+    attack: AttackStats;
+    serve: ServeStats;
+    reception: ReceptionStats;
+    block: BlockStats;
+    setting: SettingStats;
+    defense: DefenseStats;
+    misc: MiscStats;
+}
+export interface BoxScoreTotals {
+    attack: AttackStats;
+    serve: ServeStats;
+    reception: ReceptionStats;
+    block: BlockStats;
+    setting: SettingStats;
+    defense: DefenseStats;
+    misc: MiscStats;
+}
+export declare class BoxScore {
+    readonly playerId: string;
+    readonly matchSetId: string;
+    readonly attack: AttackStats;
+    readonly serve: ServeStats;
+    readonly reception: ReceptionStats;
+    readonly block: BlockStats;
+    readonly setting: SettingStats;
+    readonly defense: DefenseStats;
+    readonly misc: MiscStats;
+    private constructor();
+    static create(input: unknown): BoxScore;
+    static createEmptyAttackStats: () => AttackStats;
+    static createEmptyServeStats: () => ServeStats;
+    static createEmptyReceptionStats: () => ReceptionStats;
+    static createEmptyBlockStats: () => BlockStats;
+    static createEmptySettingStats: () => SettingStats;
+    static createEmptyDefenseStats: () => DefenseStats;
+    static createEmptyMiscStats: () => MiscStats;
+    static createEmptyBoxScore: (playerId: string, matchSetId: string) => BoxScore;
+}

package/dist/esm/src/service/match/box-score.js

@@ -0,0 +1,76 @@
+import { BoxScoreInputSchema } from './schemas/box-score.z';
+export class BoxScore {
+    constructor({ playerId, matchSetId, attack, serve, reception, block, setting, defense, misc }) {
+        this.playerId = playerId;
+        this.matchSetId = matchSetId;
+        this.attack = attack;
+        this.serve = serve;
+        this.reception = reception;
+        this.block = block;
+        this.setting = setting;
+        this.defense = defense;
+        this.misc = misc;
+    }
+    static create(input) {
+        const result = BoxScoreInputSchema.safeParse(input);
+        if (!result.success) {
+            throw new Error(`INVALID_BOX_SCORE: ${result.error.message}. RECEIVED=${(() => { try {
+                return JSON.stringify(input);
+            }
+            catch {
+                return String(input);
+            } })()}`);
+        }
+        return new BoxScore(result.data);
+    }
+}
+BoxScore.createEmptyAttackStats = () => ({
+    attempts: 0,
+    kills: 0,
+    errors: 0
+});
+BoxScore.createEmptyServeStats = () => ({
+    attempts: 0,
+    aces: 0,
+    errors: 0
+});
+BoxScore.createEmptyReceptionStats = () => ({
+    attempts: 0,
+    perfect: 0,
+    positive: 0,
+    overpasses: 0,
+    errors: 0
+});
+BoxScore.createEmptyBlockStats = () => ({
+    solo: 0,
+    assists: 0,
+    errors: 0,
+    touches: 0
+});
+BoxScore.createEmptySettingStats = () => ({
+    assists: 0,
+    errors: 0,
+    pass: 0
+});
+BoxScore.createEmptyDefenseStats = () => ({
+    digs: 0,
+    errors: 0
+});
+BoxScore.createEmptyMiscStats = () => ({
+    pointsPlayed: 0,
+    pointsWonOnCourt: 0,
+    serveTurns: 0,
+    sideoutOpportunities: 0,
+    successfulSideouts: 0
+});
+BoxScore.createEmptyBoxScore = (playerId, matchSetId) => new BoxScore({
+    playerId,
+    matchSetId,
+    attack: BoxScore.createEmptyAttackStats(),
+    serve: BoxScore.createEmptyServeStats(),
+    reception: BoxScore.createEmptyReceptionStats(),
+    block: BoxScore.createEmptyBlockStats(),
+    setting: BoxScore.createEmptySettingStats(),
+    defense: BoxScore.createEmptyDefenseStats(),
+    misc: BoxScore.createEmptyMiscStats()
+});

package/dist/esm/src/service/match/court-position.d.ts

@@ -0,0 +1,34 @@
+export declare enum CourtRow {
+    BACK = "BACK_ROW",
+    FRONT = "FRONT_ROW"
+}
+export declare enum CourtPosition {
+    NOT_IN_COURT = -1,
+    LIBERO_ZONE = 0,
+    LEFT_FRONT = 4,
+    MIDDLE_FRONT = 3,
+    RIGHT_FRONT = 2,
+    LEFT_BACK = 5,
+    MIDDLE_BACK = 6,
+    RIGHT_BACK = 1
+}
+export declare enum CourtTarget {
+    NO_TARGET = 0,
+    OPPONENT_RIGHT_BACK = 7,
+    OPPONENT_MIDDLE_BACK = 12,
+    OPPONENT_LEFT_BACK = 11,
+    OPPONENT_RIGHT_FRONT = 8,
+    OPPONENT_MIDDLE_FRONT = 9,
+    OPPONENT_LEFT_FRONT = 10,
+    TEAM_LEFT_FRONT = 4,
+    TEAM_MIDDLE_FRONT = 3,
+    TEAM_RIGHT_FRONT = 2,
+    TEAM_LEFT_BACK = 5,
+    TEAM_MIDDLE_BACK = 6,
+    TEAM_RIGHT_BACK = 1
+}
+export declare function getPositions(): CourtPosition[];
+export declare function rotatePosition(position: number): CourtPosition;
+export declare function isFrontRow(position: number): boolean;
+export declare function isBackRow(position: number): boolean;
+export declare function getCourtRow(row: CourtRow): CourtPosition[];

package/dist/esm/src/service/match/court-position.js

@@ -0,0 +1,62 @@
+export var CourtRow;
+(function (CourtRow) {
+    CourtRow["BACK"] = "BACK_ROW";
+    CourtRow["FRONT"] = "FRONT_ROW";
+})(CourtRow || (CourtRow = {}));
+export var CourtPosition;
+(function (CourtPosition) {
+    CourtPosition[CourtPosition["NOT_IN_COURT"] = -1] = "NOT_IN_COURT";
+    CourtPosition[CourtPosition["LIBERO_ZONE"] = 0] = "LIBERO_ZONE";
+    // -----------------------------------------------------
+    CourtPosition[CourtPosition["LEFT_FRONT"] = 4] = "LEFT_FRONT";
+    CourtPosition[CourtPosition["MIDDLE_FRONT"] = 3] = "MIDDLE_FRONT";
+    CourtPosition[CourtPosition["RIGHT_FRONT"] = 2] = "RIGHT_FRONT";
+    CourtPosition[CourtPosition["LEFT_BACK"] = 5] = "LEFT_BACK";
+    CourtPosition[CourtPosition["MIDDLE_BACK"] = 6] = "MIDDLE_BACK";
+    CourtPosition[CourtPosition["RIGHT_BACK"] = 1] = "RIGHT_BACK";
+})(CourtPosition || (CourtPosition = {}));
+export var CourtTarget;
+(function (CourtTarget) {
+    CourtTarget[CourtTarget["NO_TARGET"] = 0] = "NO_TARGET";
+    CourtTarget[CourtTarget["OPPONENT_RIGHT_BACK"] = 7] = "OPPONENT_RIGHT_BACK";
+    CourtTarget[CourtTarget["OPPONENT_MIDDLE_BACK"] = 12] = "OPPONENT_MIDDLE_BACK";
+    CourtTarget[CourtTarget["OPPONENT_LEFT_BACK"] = 11] = "OPPONENT_LEFT_BACK";
+    CourtTarget[CourtTarget["OPPONENT_RIGHT_FRONT"] = 8] = "OPPONENT_RIGHT_FRONT";
+    CourtTarget[CourtTarget["OPPONENT_MIDDLE_FRONT"] = 9] = "OPPONENT_MIDDLE_FRONT";
+    CourtTarget[CourtTarget["OPPONENT_LEFT_FRONT"] = 10] = "OPPONENT_LEFT_FRONT";
+    // --------------------------------------------------------------------------------
+    CourtTarget[CourtTarget["TEAM_LEFT_FRONT"] = 4] = "TEAM_LEFT_FRONT";
+    CourtTarget[CourtTarget["TEAM_MIDDLE_FRONT"] = 3] = "TEAM_MIDDLE_FRONT";
+    CourtTarget[CourtTarget["TEAM_RIGHT_FRONT"] = 2] = "TEAM_RIGHT_FRONT";
+    CourtTarget[CourtTarget["TEAM_LEFT_BACK"] = 5] = "TEAM_LEFT_BACK";
+    CourtTarget[CourtTarget["TEAM_MIDDLE_BACK"] = 6] = "TEAM_MIDDLE_BACK";
+    CourtTarget[CourtTarget["TEAM_RIGHT_BACK"] = 1] = "TEAM_RIGHT_BACK";
+})(CourtTarget || (CourtTarget = {}));
+const FRONT_ROW = [CourtPosition.LEFT_FRONT, CourtPosition.MIDDLE_FRONT, CourtPosition.RIGHT_FRONT];
+const BACK_ROW = [CourtPosition.LEFT_BACK, CourtPosition.MIDDLE_BACK, CourtPosition.RIGHT_BACK];
+export function getPositions() {
+    return [...BACK_ROW, ...FRONT_ROW];
+}
+export function rotatePosition(position) {
+    if (position < 1 || position > 6)
+        throw new Error('POSITION_INDEX_OUT_OF_BOUNDS');
+    if (position > CourtPosition.RIGHT_BACK)
+        return position - 1;
+    else
+        return CourtPosition.MIDDLE_BACK;
+}
+export function isFrontRow(position) {
+    if (position < 1 || position > 6)
+        throw new Error('POSITION_INDEX_OUT_OF_BOUNDS');
+    return FRONT_ROW.includes(position);
+}
+export function isBackRow(position) {
+    if (position < 1 || position > 6)
+        throw new Error(`POSITION_INDEX_OUT_OF_BOUNDS: ${position}`);
+    return BACK_ROW.includes(position);
+}
+export function getCourtRow(row) {
+    if (![CourtRow.BACK, CourtRow.FRONT].includes(row))
+        throw new Error(`INVALID_ROW: ${row}`);
+    return CourtRow.BACK === row ? [...BACK_ROW] : [...FRONT_ROW];
+}

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

@@ -0,0 +1,9 @@
+export * from './box-score';
+export * from './match';
+export * from './match-generator';
+export * from './match-rating';
+export * from './match-set';
+export * from './rally';
+export * from './court-position';
+export * from './match-team';
+export * from './vper';

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

@@ -0,0 +1,9 @@
+export * from './box-score';
+export * from './match';
+export * from './match-generator';
+export * from './match-rating';
+export * from './match-set';
+export * from './rally';
+export * from './court-position';
+export * from './match-team';
+export * from './vper';

package/dist/esm/src/service/match/match-generator.d.ts

@@ -0,0 +1,5 @@
+import { Team } from '../team';
+import { Match } from './match';
+export default class MatchGenerator {
+    static generateMatches(teams: Team[], baseDate: Date): Match[];
+}

package/dist/esm/src/service/match/match-generator.js

@@ -0,0 +1,67 @@
+import dayjs from 'dayjs';
+import { v4 as uuidv4 } from 'uuid';
+import { Match } from './match';
+import { shuffle } from '../utils';
+import { StatusEnum } from '../../data';
+// eslint-disable-next-line @typescript-eslint/no-extraneous-class
+export default class MatchGenerator {
+    static generateMatches(teams, baseDate) {
+        const t = new Set(teams.map(x => x.id));
+        let date = dayjs(baseDate).startOf('hour');
+        if (t.size !== teams.length) {
+            throw new Error('DUPLICATE_TEAMS');
+        }
+        let shuffled = shuffle([...teams]);
+        const l = shuffled.length - 1;
+        const half = Math.ceil(shuffled.length / 2);
+        const matches = [];
+        // We fix the first team
+        let firstTeam = shuffled.shift();
+        if (firstTeam == null) {
+            throw new Error('EMPTY_TEAM_ARRAY');
+        }
+        let homeRow;
+        let awayRow;
+        for (let i = 0; i < l; i++) {
+            // split array in 2 halves
+            const row1 = shuffled.slice(0, half);
+            const row2 = shuffled.slice(half);
+            row2.push(firstTeam);
+            if (i % 2 === 0) {
+                homeRow = row1;
+                awayRow = row2;
+            }
+            else {
+                homeRow = row2;
+                awayRow = row1;
+            }
+            for (let j = 0; j < half; j++) {
+                matches.push(Match.create({
+                    id: uuidv4(),
+                    homeTeam: homeRow[j],
+                    awayTeam: awayRow[j],
+                    scheduledDate: date.toDate(),
+                    status: StatusEnum.PENDING
+                }));
+                date = date.add(30, 'minutes');
+            }
+            firstTeam = row2.pop();
+            row1.unshift(row2.shift());
+            row2.push(row1.pop());
+            shuffled = [...row1, ...row2];
+        }
+        // Generate Inverted matches for home-away pairings
+        matches.push(...matches.map(match => {
+            const scheduledDate = date.toDate();
+            date = date.add(30, 'minutes');
+            return Match.create({
+                id: uuidv4(),
+                homeTeam: match.awayTeam,
+                awayTeam: match.homeTeam,
+                scheduledDate,
+                status: StatusEnum.PENDING
+            });
+        }));
+        return matches;
+    }
+}

package/dist/esm/src/service/match/match-rating.d.ts

@@ -0,0 +1,34 @@
+import { Match, MatchTeam } from '.';
+import { MatchContext } from './schemas/match-rating.z';
+export type { MatchContext };
+interface SetScoreVariant {
+    '3-0': number;
+    '3-1': number;
+    '3-2': number;
+    '2-3': number;
+    '1-3': number;
+    '0-3': number;
+}
+export declare class MatchRating {
+    static readonly K: number;
+    static readonly C1: number;
+    static readonly C2: number;
+    static readonly C3: number;
+    static readonly C4: number;
+    static readonly C5: number;
+    static readonly SSV: SetScoreVariant;
+    static readonly LEAGUE_BASE: number;
+    static readonly TIER_PENALTY: number;
+    static readonly QUALIFIER_WEIGHT: number;
+    static readonly TOURNAMENT_WEIGHT: number;
+    readonly match: Match;
+    readonly weight: number;
+    static create(input: unknown): MatchRating;
+    private constructor();
+    private static leagueWeight;
+    private static applyBotPenalty;
+    private static computeWeight;
+    static calculateProbability(z: number): number;
+    getExpectedResult(): number;
+    getPoints(team: MatchTeam): number;
+}

package/dist/esm/src/service/match/match-rating.js

@@ -0,0 +1,93 @@
+import { MatchTeam } from '.';
+import { erf } from '../utils';
+import { MatchRatingInputSchema } from './schemas/match-rating.z';
+export class MatchRating {
+    static create(input) {
+        const result = MatchRatingInputSchema.safeParse(input);
+        if (!result.success) {
+            throw new Error(`INVALID_MATCH_RATING: ${result.error.message}. RECEIVED=${(() => { try {
+                return JSON.stringify(input);
+            }
+            catch {
+                return String(input);
+            } })()}`);
+        }
+        return new MatchRating(result.data);
+    }
+    constructor({ match, context }) {
+        this.match = match;
+        this.weight = MatchRating.computeWeight(context);
+    }
+    static leagueWeight(tier) {
+        return Math.max(MatchRating.TIER_PENALTY, MatchRating.LEAGUE_BASE - MatchRating.TIER_PENALTY * tier);
+    }
+    static applyBotPenalty(weight, homeIsBot, awayIsBot) {
+        const bots = (homeIsBot ? 1 : 0) + (awayIsBot ? 1 : 0);
+        return weight * Math.pow(0.5, bots);
+    }
+    static computeWeight(context) {
+        switch (context.kind) {
+            case 'LEAGUE': {
+                const base = MatchRating.leagueWeight(context.tier);
+                return MatchRating.applyBotPenalty(base, context.homeIsBot, context.awayIsBot);
+            }
+            case 'PROMOTION': {
+                const base = (MatchRating.leagueWeight(context.upperTier) + MatchRating.leagueWeight(context.lowerTier)) / 2;
+                return MatchRating.applyBotPenalty(base, context.homeIsBot, context.awayIsBot);
+            }
+            case 'QUALIFIER':
+                return MatchRating.applyBotPenalty(MatchRating.QUALIFIER_WEIGHT, context.homeIsBot, context.awayIsBot);
+            case 'TOURNAMENT':
+                return MatchRating.applyBotPenalty(MatchRating.TOURNAMENT_WEIGHT, context.homeIsBot, context.awayIsBot);
+        }
+    }
+    static calculateProbability(z) {
+        return 0.5 * (1 + erf(z / Math.SQRT2));
+    }
+    getExpectedResult() {
+        const D = MatchRating.K * (this.match.homeTeam.rating - this.match.awayTeam.rating) / 1000;
+        const P1 = MatchRating.calculateProbability(MatchRating.C1 + D);
+        const P2 = MatchRating.calculateProbability(MatchRating.C2 + D) - MatchRating.calculateProbability(MatchRating.C1 + D);
+        const P3 = MatchRating.calculateProbability(MatchRating.C3 + D) - MatchRating.calculateProbability(MatchRating.C2 + D);
+        const P4 = MatchRating.calculateProbability(MatchRating.C4 + D) - MatchRating.calculateProbability(MatchRating.C3 + D);
+        const P5 = MatchRating.calculateProbability(MatchRating.C5 + D) - MatchRating.calculateProbability(MatchRating.C4 + D);
+        const P6 = 1 - MatchRating.calculateProbability(MatchRating.C5 + D);
+        return P1 * MatchRating.SSV['3-0'] +
+            P2 * MatchRating.SSV['3-1'] +
+            P3 * MatchRating.SSV['3-2'] +
+            P4 * MatchRating.SSV['2-3'] +
+            P5 * MatchRating.SSV['1-3'] +
+            P6 * MatchRating.SSV['0-3'];
+    }
+    getPoints(team) {
+        const homeScoreKey = this.match.getScore();
+        const emr = this.getExpectedResult();
+        const ssv = MatchRating.SSV[homeScoreKey];
+        const homeDelta = (ssv - emr) * this.weight / MatchRating.K;
+        return team === MatchTeam.HOME ? homeDelta : -homeDelta;
+    }
+}
+// Standard scaling factor (FIVB spec)
+MatchRating.K = 8;
+// Cut-points for the normal distribution (symmetric, equal-strength baseline)
+MatchRating.C1 = -1.060;
+MatchRating.C2 = -0.394;
+MatchRating.C3 = 0;
+MatchRating.C4 = 0.394;
+MatchRating.C5 = 1.060;
+MatchRating.SSV = {
+    '3-0': 2,
+    '3-1': 1.5,
+    '3-2': 1,
+    '2-3': -1,
+    '1-3': -1.5,
+    '0-3': -2
+};
+// League weight = LEAGUE_BASE - TIER_PENALTY * tier
+// Tier 1 → 35, Tier 2 → 30, Tier 3 → 25, Tier 4 → 20, ...
+MatchRating.LEAGUE_BASE = 40;
+MatchRating.TIER_PENALTY = 5;
+// Regional qualifier — higher prestige than any league tier
+MatchRating.QUALIFIER_WEIGHT = 45;
+// WCC tournament — top of the hierarchy
+MatchRating.TOURNAMENT_WEIGHT = 55;

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

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

package/dist/esm/src/service/match/match-rating.test.js

@@ -0,0 +1,144 @@
+import { describe, it, expect } from '@jest/globals';
+import { MatchRating } from './match-rating';
+import { MatchTeam } from './match-team';
+import { makeTeam, makeMatch30, makeMatch31 } from '../test-helpers';
+import { erf } from '../utils/number-utils';
+// ─── MatchRating.calculateProbability (static normal CDF) ───────────────────
+describe('MatchRating.calculateProbability()', () => {
+    it('returns 0.5 at z = 0 (symmetric distribution)', () => {
+        expect(MatchRating.calculateProbability(0)).toBeCloseTo(0.5, 5);
+    });
+    it('is monotone: P(z1) < P(z2) when z1 < z2', () => {
+        expect(MatchRating.calculateProbability(-1))
+            .toBeLessThan(MatchRating.calculateProbability(0));
+        expect(MatchRating.calculateProbability(0))
+            .toBeLessThan(MatchRating.calculateProbability(1));
+    });
+    it('approaches 1 for large positive z', () => {
+        expect(MatchRating.calculateProbability(10)).toBeCloseTo(1, 5);
+    });
+    it('approaches 0 for large negative z', () => {
+        expect(MatchRating.calculateProbability(-10)).toBeCloseTo(0, 5);
+    });
+    it('matches the formula 0.5 * (1 + erf(z / sqrt(2)))', () => {
+        for (const z of [-2, -1, 0, 1, 2]) {
+            expect(MatchRating.calculateProbability(z))
+                .toBeCloseTo(0.5 * (1 + erf(z / Math.SQRT2)), 8);
+        }
+    });
+});
+// ─── weight computation ───────────────────────────────────────────────────────
+describe('MatchRating weight computation', () => {
+    function makeRating(context) {
+        const home = makeTeam();
+        const away = makeTeam();
+        const match = makeMatch30(home, away);
+        return MatchRating.create({ match, context });
+    }
+    it('LEAGUE tier 1 → weight = LEAGUE_BASE - TIER_PENALTY * 1 = 35', () => {
+        const mr = makeRating({ kind: 'LEAGUE', tier: 1, homeIsBot: false, awayIsBot: false });
+        expect(mr.weight).toBe(35);
+    });
+    it('LEAGUE tier 7 → weight is floored at TIER_PENALTY (5)', () => {
+        // 40 - 5*7 = 5 (minimum is TIER_PENALTY itself)
+        const mr = makeRating({ kind: 'LEAGUE', tier: 7, homeIsBot: false, awayIsBot: false });
+        expect(mr.weight).toBe(5);
+    });
+    it('QUALIFIER → weight = QUALIFIER_WEIGHT (45)', () => {
+        const mr = makeRating({ kind: 'QUALIFIER', homeIsBot: false, awayIsBot: false });
+        expect(mr.weight).toBe(45);
+    });
+    it('TOURNAMENT → weight = TOURNAMENT_WEIGHT (55)', () => {
+        const mr = makeRating({ kind: 'TOURNAMENT', homeIsBot: false, awayIsBot: false });
+        expect(mr.weight).toBe(55);
+    });
+    it('each bot halves the weight', () => {
+        const noBots = makeRating({ kind: 'QUALIFIER', homeIsBot: false, awayIsBot: false });
+        const oneBot = makeRating({ kind: 'QUALIFIER', homeIsBot: true, awayIsBot: false });
+        const twoBots = makeRating({ kind: 'QUALIFIER', homeIsBot: true, awayIsBot: true });
+        expect(oneBot.weight).toBeCloseTo(noBots.weight * 0.5, 10);
+        expect(twoBots.weight).toBeCloseTo(noBots.weight * 0.25, 10);
+    });
+    it('PROMOTION weight is the average of the two league tier weights', () => {
+        // upperTier=1 (35), lowerTier=2 (30) → avg = 32.5
+        const mr = makeRating({ kind: 'PROMOTION', upperTier: 1, lowerTier: 2, homeIsBot: false, awayIsBot: false });
+        expect(mr.weight).toBeCloseTo(32.5, 5);
+    });
+});
+// ─── getExpectedResult ────────────────────────────────────────────────────────
+describe('MatchRating.getExpectedResult()', () => {
+    function makeRatingForTeams(homeRating, awayRating) {
+        const home = makeTeam({ rating: homeRating });
+        const away = makeTeam({ rating: awayRating });
+        const match = makeMatch30(home, away);
+        return MatchRating.create({ match, context: { kind: 'LEAGUE', tier: 1, homeIsBot: false, awayIsBot: false } });
+    }
+    it('returns 0 when both teams have equal rating', () => {
+        const mr = makeRatingForTeams(1000, 1000);
+        expect(mr.getExpectedResult()).toBeCloseTo(0, 5);
+    });
+    it('returns a positive value when home team is stronger', () => {
+        const mr = makeRatingForTeams(1500, 1000);
+        expect(mr.getExpectedResult()).toBeGreaterThan(0);
+    });
+    it('returns a negative value when away team is stronger', () => {
+        const mr = makeRatingForTeams(1000, 1500);
+        expect(mr.getExpectedResult()).toBeLessThan(0);
+    });
+    it('is antisymmetric: EMR(h, a) = -EMR(a, h)', () => {
+        const mr1 = makeRatingForTeams(1200, 800);
+        const mr2 = makeRatingForTeams(800, 1200);
+        expect(mr1.getExpectedResult()).toBeCloseTo(-mr2.getExpectedResult(), 8);
+    });
+});
+// ─── getPoints ────────────────────────────────────────────────────────────────
+describe('MatchRating.getPoints()', () => {
+    it('home and away deltas are opposite signs', () => {
+        const home = makeTeam({ rating: 1000 });
+        const away = makeTeam({ rating: 1000 });
+        const match = makeMatch30(home, away);
+        const mr = MatchRating.create({ match, context: { kind: 'LEAGUE', tier: 1, homeIsBot: false, awayIsBot: false } });
+        expect(mr.getPoints(MatchTeam.HOME)).toBeCloseTo(-mr.getPoints(MatchTeam.AWAY), 10);
+    });
+    it('winning home team gains positive points against equal opponent (3-0)', () => {
+        const home = makeTeam({ rating: 1000 });
+        const away = makeTeam({ rating: 1000 });
+        const match = makeMatch30(home, away);
+        const mr = MatchRating.create({ match, context: { kind: 'LEAGUE', tier: 1, homeIsBot: false, awayIsBot: false } });
+        // ssv['3-0'] = 2, emr = 0 for equal teams → homeDelta = 2 * weight / K > 0
+        expect(mr.getPoints(MatchTeam.HOME)).toBeGreaterThan(0);
+        expect(mr.getPoints(MatchTeam.AWAY)).toBeLessThan(0);
+    });
+    it('match winner earns fewer points when they were heavily favoured', () => {
+        // Strong home team beats weak away — less surprising, fewer points
+        const strongHome = makeTeam({ rating: 2000 });
+        const weakAway = makeTeam({ rating: 500 });
+        const evenHome = makeTeam({ rating: 1000 });
+        const evenAway = makeTeam({ rating: 1000 });
+        const surpriseMr = MatchRating.create({
+            match: makeMatch30(evenHome, evenAway),
+            context: { kind: 'LEAGUE', tier: 1, homeIsBot: false, awayIsBot: false }
+        });
+        const expectedMr = MatchRating.create({
+            match: makeMatch30(strongHome, weakAway),
+            context: { kind: 'LEAGUE', tier: 1, homeIsBot: false, awayIsBot: false }
+        });
+        // Equal-match 3-0 win earns more points than a heavily favoured 3-0 win
+        expect(surpriseMr.getPoints(MatchTeam.HOME))
+            .toBeGreaterThan(expectedMr.getPoints(MatchTeam.HOME));
+    });
+    it('3-1 win earns fewer points than a 3-0 win (SSV difference)', () => {
+        const home = makeTeam({ rating: 1000 });
+        const away = makeTeam({ rating: 1000 });
+        const win30 = MatchRating.create({
+            match: makeMatch30(home, away),
+            context: { kind: 'LEAGUE', tier: 1, homeIsBot: false, awayIsBot: false }
+        });
+        const away2 = makeTeam({ rating: 1000 });
+        const win31 = MatchRating.create({
+            match: makeMatch31(home, away2),
+            context: { kind: 'LEAGUE', tier: 1, homeIsBot: false, awayIsBot: false }
+        });
+        expect(win30.getPoints(MatchTeam.HOME)).toBeGreaterThan(win31.getPoints(MatchTeam.HOME));
+    });
+});

package/dist/esm/src/service/match/match-set.d.ts

@@ -0,0 +1,33 @@
+import { PlayerPosition, Rally } from './rally';
+import { MatchTeam } from './match-team';
+import { BoxScore } from './box-score';
+type ScoreThreshold = 25 | 15;
+export declare class MatchSet {
+    readonly id: string;
+    readonly order: number;
+    readonly isTieBreak: boolean;
+    readonly homePlayerPosition: PlayerPosition[];
+    readonly awayPlayerPosition: PlayerPosition[];
+    readonly boxScores: BoxScore[];
+    readonly rallies: Rally[];
+    readonly scoreThreshold: ScoreThreshold;
+    private _homeScore;
+    private _awayScore;
+    static create(input: unknown): MatchSet;
+    private constructor();
+    get homeScore(): number;
+    get awayScore(): number;
+    increaseScore(team: MatchTeam): void;
+    addRally(rally: Rally): void;
+    /**
+     * Has a team reached at least 25 points, and is the score difference between both teams at least 2?
+     * @returns boolean
+     */
+    isOver(): boolean;
+    /**
+     * Get the team that won the Set. Return undefined if set is not over.
+     * @returns CourtTeam
+     */
+    getWinner(): MatchTeam;
+}
+export {};