volleyballsimtypes 0.0.217 → 0.0.358

package/dist/esm/src/service/player/player.js

@@ -1,90 +1,118 @@
-import { validateUUID } from '../utils';
-import { calculateStatScore, StatsEnum } from './stats';
-import { calculateRoleScore } from './role';
-export class Stat {
-    constructor({ name, value }) {
-        this.name = name;
-        this.value = value;
-    }
-    toString() {
-        return `${this.name}: ${this.value}`;
-    }
-}
-export class Name {
-    constructor({ first, last }) {
-        this.first = first;
-        this.last = last;
-    }
-    toString() {
-        return `${this.first} ${this.last}`;
-    }
-}
-export class Player {
-    constructor({ id, name, country, stats, roles, traits, rarity, boxScores, boxScoreTotals }) {
-        validateUUID(id);
-        this.id = id;
-        this.name = name;
-        this.country = country;
-        this.stats = stats;
-        this.roles = roles;
-        this.traits = traits;
-        this.rarity = rarity;
-        this.boxScores = boxScores;
-        this.boxScoreTotals = boxScoreTotals;
-        this.generalStats = Object.values(StatsEnum).map((stat) => ({
-            name: stat,
-            value: calculateStatScore(stats, stat)
-        }));
-    }
-    // Used as a base sorting function for players
-    static sortPlayers(roles) {
-        return (p1, p2) => roles.reduce((x, role) => {
-            const p2Score = calculateRoleScore(p2.stats, role);
-            const p1Score = calculateRoleScore(p1.stats, role);
-            return x + p2Score - p1Score;
-        }, 0);
-    }
-    static compareStats(p1, p2) {
-        const compareFn = (acc, current) => {
-            let x = current.value;
-            switch (current.name) {
-                case StatsEnum.ATTACK:
-                    x *= 0.19;
-                    break;
-                case StatsEnum.SET:
-                    x *= 0.19;
-                    break;
-                case StatsEnum.RECEIVE:
-                    x *= 0.19;
-                    break;
-                case StatsEnum.BLOCK:
-                    x *= 0.19;
-                    break;
-                case StatsEnum.SERVE:
-                    x *= 0.19;
-                    break;
-                case StatsEnum.STAMINA:
-                    x *= 0.05;
-                    break;
-                default:
-                    x *= 0;
-            }
-            return acc + x;
-        };
-        const s1 = p1.generalStats.reduce(compareFn, 0);
-        const s2 = p2.generalStats.reduce(compareFn, 0);
-        return s2 - s1;
-    }
-    toString() {
-        return JSON.stringify({
-            id: this.id,
-            name: this.name.toString(),
-            country: this.country.toString(),
-            stats: this.stats.toString(),
-            rarity: this.rarity,
-            roles: `[${this.roles.map(r => r.toString()).join(',')}]`,
-            traits: `[${this.traits.map(t => t.toString()).join(',')}]`,
-            generalStats: `[${this.generalStats.map(r => r.toString()).join(',')}]`
-        });
-    }
-}
+import { PerformanceStats } from './performance-stats';
+import { calculateStatScore, StatsEnum } from './stats';
+import { calculateRoleScore } from './role';
+import { NameInputSchema, PlayerInputSchema } from './schemas/player.z';
+export class Stat {
+    constructor({ name, value }) {
+        this.name = name;
+        this.value = value;
+    }
+    toString() {
+        return `${this.name}: ${this.value}`;
+    }
+}
+export class Name {
+    static create(input) {
+        const result = NameInputSchema.safeParse(input);
+        if (!result.success) {
+            throw new Error(`INVALID_NAME: ${result.error.message}. RECEIVED=${(() => { try {
+                return JSON.stringify(input);
+            }
+            catch {
+                return String(input);
+            } })()}`);
+        }
+        return new Name(result.data);
+    }
+    constructor({ first, last }) {
+        this.first = first;
+        this.last = last;
+    }
+    toString() {
+        return `${this.first} ${this.last}`;
+    }
+}
+export class Player {
+    static create(input) {
+        const result = PlayerInputSchema.safeParse(input);
+        if (!result.success) {
+            throw new Error(`INVALID_PLAYER: ${result.error.message}. RECEIVED=${(() => { try {
+                return JSON.stringify(input);
+            }
+            catch {
+                return String(input);
+            } })()}`);
+        }
+        return new Player({
+            ...result.data,
+            name: Name.create(result.data.name),
+            stats: PerformanceStats.create(result.data.stats)
+        });
+    }
+    constructor({ id, name, country, stats, roles, traits, rarity, boxScores, boxScoreTotals }) {
+        this.id = id;
+        this.name = name;
+        this.country = country;
+        this.stats = stats;
+        this.roles = roles;
+        this.traits = traits;
+        this.rarity = rarity;
+        this.boxScores = boxScores;
+        this.boxScoreTotals = boxScoreTotals;
+        this.generalStats = Object.values(StatsEnum).map((stat) => ({
+            name: stat,
+            value: calculateStatScore(stats, stat)
+        }));
+    }
+    // Used as a base sorting function for players
+    static sortPlayers(roles) {
+        return (p1, p2) => roles.reduce((x, role) => {
+            const p2Score = calculateRoleScore(p2.stats, role);
+            const p1Score = calculateRoleScore(p1.stats, role);
+            return x + p2Score - p1Score;
+        }, 0);
+    }
+    static compareStats(p1, p2) {
+        const compareFn = (acc, current) => {
+            let x = current.value;
+            switch (current.name) {
+                case StatsEnum.ATTACK:
+                    x *= 0.19;
+                    break;
+                case StatsEnum.SET:
+                    x *= 0.19;
+                    break;
+                case StatsEnum.RECEIVE:
+                    x *= 0.19;
+                    break;
+                case StatsEnum.BLOCK:
+                    x *= 0.19;
+                    break;
+                case StatsEnum.SERVE:
+                    x *= 0.19;
+                    break;
+                case StatsEnum.STAMINA:
+                    x *= 0.05;
+                    break;
+                default:
+                    x *= 0;
+            }
+            return acc + x;
+        };
+        const s1 = p1.generalStats.reduce(compareFn, 0);
+        const s2 = p2.generalStats.reduce(compareFn, 0);
+        return s2 - s1;
+    }
+    toString() {
+        return JSON.stringify({
+            id: this.id,
+            name: this.name.toString(),
+            country: this.country.toString(),
+            stats: this.stats.toString(),
+            rarity: this.rarity,
+            roles: `[${this.roles.map(r => r.toString()).join(',')}]`,
+            traits: `[${this.traits.map(t => t.toString()).join(',')}]`,
+            generalStats: `[${this.generalStats.map(r => r.toString()).join(',')}]`
+        });
+    }
+}

package/dist/esm/src/service/player/rarity.d.ts

@@ -1,15 +1,15 @@
-export declare enum RarityEnum {
-    COMMON = "COMMON",
-    RARE = "RARE",
-    LEGENDARY = "LEGENDARY",
-    MYTHIC = "MYTHIC",
-    SPECIAL = "SPECIAL"
-}
-export type Rarity = RarityEnum.COMMON | RarityEnum.RARE | RarityEnum.LEGENDARY | RarityEnum.MYTHIC | RarityEnum.SPECIAL;
-export declare const RarityRanges: {
-    COMMON: number[];
-    RARE: number[];
-    LEGENDARY: number[];
-    MYTHIC: number[];
-    SPECIAL: number[];
-};
+export declare enum RarityEnum {
+    COMMON = "COMMON",
+    RARE = "RARE",
+    LEGENDARY = "LEGENDARY",
+    MYTHIC = "MYTHIC",
+    SPECIAL = "SPECIAL"
+}
+export type Rarity = RarityEnum.COMMON | RarityEnum.RARE | RarityEnum.LEGENDARY | RarityEnum.MYTHIC | RarityEnum.SPECIAL;
+export declare const RarityRanges: {
+    COMMON: number[];
+    RARE: number[];
+    LEGENDARY: number[];
+    MYTHIC: number[];
+    SPECIAL: number[];
+};

package/dist/esm/src/service/player/rarity.js

@@ -1,15 +1,15 @@
-export var RarityEnum;
-(function (RarityEnum) {
-    RarityEnum["COMMON"] = "COMMON";
-    RarityEnum["RARE"] = "RARE";
-    RarityEnum["LEGENDARY"] = "LEGENDARY";
-    RarityEnum["MYTHIC"] = "MYTHIC";
-    RarityEnum["SPECIAL"] = "SPECIAL";
-})(RarityEnum || (RarityEnum = {}));
-export const RarityRanges = {
-    [RarityEnum.COMMON]: [0, 50],
-    [RarityEnum.RARE]: [51, 70],
-    [RarityEnum.LEGENDARY]: [71, 85],
-    [RarityEnum.MYTHIC]: [86, 98],
-    [RarityEnum.SPECIAL]: [99, 100]
-};
+export var RarityEnum;
+(function (RarityEnum) {
+    RarityEnum["COMMON"] = "COMMON";
+    RarityEnum["RARE"] = "RARE";
+    RarityEnum["LEGENDARY"] = "LEGENDARY";
+    RarityEnum["MYTHIC"] = "MYTHIC";
+    RarityEnum["SPECIAL"] = "SPECIAL";
+})(RarityEnum || (RarityEnum = {}));
+export const RarityRanges = {
+    [RarityEnum.COMMON]: [1, 59],
+    [RarityEnum.RARE]: [51, 69],
+    [RarityEnum.LEGENDARY]: [71, 79],
+    [RarityEnum.MYTHIC]: [80, 89],
+    [RarityEnum.SPECIAL]: [90, 99]
+};

package/dist/esm/src/service/player/role.d.ts

@@ -1,15 +1,28 @@
-import { PerformanceStats, PerformanceStatsParams } from './performance-stats';
-export declare enum RoleEnum {
-    SETTER = "SETTER",
-    LIBERO = "LIBERO",
-    OUTSIDE_HITTER = "OUTSIDE_HITTER",
-    OPPOSITE_HITTER = "OPPOSITE_HITTER",
-    MIDDLE_BLOCKER = "MIDDLE_BLOCKER"
-}
-export type Role = RoleEnum.SETTER | RoleEnum.LIBERO | RoleEnum.MIDDLE_BLOCKER | RoleEnum.OUTSIDE_HITTER | RoleEnum.OPPOSITE_HITTER;
-export interface RolesFormula {
-    role: Role;
-    weight: PerformanceStatsParams;
-}
-export declare function calculateRoleScore(stats: PerformanceStats, role: Role): number;
-export declare function assignRoles(stats: PerformanceStats): Role[];
+import { PerformanceStats, PerformanceStatsParams } from './performance-stats';
+import { Rarity } from './rarity';
+export declare enum RoleEnum {
+    SETTER = "SETTER",
+    LIBERO = "LIBERO",
+    OUTSIDE_HITTER = "OUTSIDE_HITTER",
+    OPPOSITE_HITTER = "OPPOSITE_HITTER",
+    MIDDLE_BLOCKER = "MIDDLE_BLOCKER"
+}
+export type Role = RoleEnum.SETTER | RoleEnum.LIBERO | RoleEnum.MIDDLE_BLOCKER | RoleEnum.OUTSIDE_HITTER | RoleEnum.OPPOSITE_HITTER;
+export type RoleEventAction = 'reception' | 'set' | 'spike' | 'block';
+export interface RolesFormula {
+    role: Role;
+    weight: PerformanceStatsParams;
+}
+export declare function calculateRoleScore(stats: PerformanceStats, role: Role): number;
+export declare function assignRoles(stats: PerformanceStats, rarity: Rarity): Role[];
+/**
+ * Returns the role-based multiplier for a player performing a given action.
+ * When the player holds multiple roles, the least-penalising role wins.
+ * Defaults to the harshest penalty for that action if roles is empty.
+ */
+export declare function getRoleEventPenalty(roles: Role[], action: Exclude<RoleEventAction, 'block'>): number;
+/**
+ * Returns the role-based multiplier for a block sequence.
+ * If any blocker holds MIDDLE_BLOCKER, the whole block has no penalty.
+ */
+export declare function getBlockRolePenalty(blockerRoles: Role[][]): number;

package/dist/esm/src/service/player/role.js

@@ -1,44 +1,74 @@
-import roles from '../../stat-config/roles.json';
-export var RoleEnum;
-(function (RoleEnum) {
-    RoleEnum["SETTER"] = "SETTER";
-    RoleEnum["LIBERO"] = "LIBERO";
-    RoleEnum["OUTSIDE_HITTER"] = "OUTSIDE_HITTER";
-    RoleEnum["OPPOSITE_HITTER"] = "OPPOSITE_HITTER";
-    RoleEnum["MIDDLE_BLOCKER"] = "MIDDLE_BLOCKER";
-})(RoleEnum || (RoleEnum = {}));
-const rolesFormula = roles;
-export function calculateRoleScore(stats, role) {
-    const weights = rolesFormula.find(r => r.role === role);
-    if (weights == null)
-        throw new Error('COULD_NOT_FIND_ROLE_WEIGHT');
-    const score = Object.keys(weights.weight)
-        .reduce((score, key) => {
-        const stat = stats[key];
-        const weight = weights.weight[key];
-        return score + (stat * weight);
-    }, 0);
-    return Math.round(score);
-}
-export function assignRoles(stats) {
-    const scores = Object.values(RoleEnum)
-        .map((role) => ({
-        role,
-        score: calculateRoleScore(stats, role)
-    }))
-        .sort((x, y) => y.score - x.score);
-    const out = [scores[0].role];
-    if (scores[1].score >= 75) {
-        out.push(scores[1].role);
-    }
-    if (scores[2].score >= 82) {
-        out.push(scores[2].role);
-    }
-    if (scores[3].score >= 89) {
-        out.push(scores[3].role);
-    }
-    if (scores[4].score >= 95) {
-        out.push(scores[4].role);
-    }
-    return out;
-}
+import { RarityEnum } from './rarity';
+import roles from '../../stat-config/roles.json';
+export var RoleEnum;
+(function (RoleEnum) {
+    RoleEnum["SETTER"] = "SETTER";
+    RoleEnum["LIBERO"] = "LIBERO";
+    RoleEnum["OUTSIDE_HITTER"] = "OUTSIDE_HITTER";
+    RoleEnum["OPPOSITE_HITTER"] = "OPPOSITE_HITTER";
+    RoleEnum["MIDDLE_BLOCKER"] = "MIDDLE_BLOCKER";
+})(RoleEnum || (RoleEnum = {}));
+const rolesFormula = roles;
+// ─── Role score ───────────────────────────────────────────────────────────────
+export function calculateRoleScore(stats, role) {
+    const weights = rolesFormula.find(r => r.role === role);
+    if (weights == null)
+        throw new Error('COULD_NOT_FIND_ROLE_WEIGHT');
+    const score = Object.keys(weights.weight)
+        .reduce((score, key) => {
+        const stat = stats[key];
+        const weight = weights.weight[key];
+        return score + (stat * weight);
+    }, 0);
+    return Math.round(score);
+}
+// ─── Role assignment ──────────────────────────────────────────────────────────
+function getRoleCountRange(rarity) {
+    switch (rarity) {
+        case RarityEnum.COMMON: return [1, 2];
+        case RarityEnum.RARE: return [1, 3];
+        case RarityEnum.LEGENDARY: return [1, 4];
+        case RarityEnum.MYTHIC: return [2, 4];
+        case RarityEnum.SPECIAL: return [3, 5];
+        default: return [1, 2];
+    }
+}
+export function assignRoles(stats, rarity) {
+    const scores = Object.values(RoleEnum)
+        .map((role) => ({
+        role,
+        score: calculateRoleScore(stats, role)
+    }))
+        .sort((x, y) => y.score - x.score);
+    const [min, max] = getRoleCountRange(rarity);
+    const count = min + Math.floor(Math.random() * (max - min + 1));
+    return scores.slice(0, count).map(s => s.role);
+}
+// ─── Role event penalties ─────────────────────────────────────────────────────
+const ROLE_PENALTY_TABLE = {
+    [RoleEnum.LIBERO]: { reception: 1.00, set: 0.98, spike: 0.90 },
+    [RoleEnum.SETTER]: { reception: 0.92, set: 1.00, spike: 0.98 },
+    [RoleEnum.OUTSIDE_HITTER]: { reception: 0.95, set: 0.95, spike: 1.00 },
+    [RoleEnum.OPPOSITE_HITTER]: { reception: 0.92, set: 0.95, spike: 1.00 },
+    [RoleEnum.MIDDLE_BLOCKER]: { reception: 0.85, set: 0.90, spike: 0.95 }
+};
+/**
+ * Returns the role-based multiplier for a player performing a given action.
+ * When the player holds multiple roles, the least-penalising role wins.
+ * Defaults to the harshest penalty for that action if roles is empty.
+ */
+export function getRoleEventPenalty(roles, action) {
+    if (roles.length === 0) {
+        // fallback: use MIDDLE_BLOCKER penalties (most penalised for non-block actions)
+        return ROLE_PENALTY_TABLE[RoleEnum.MIDDLE_BLOCKER][action];
+    }
+    return Math.max(...roles.map(role => ROLE_PENALTY_TABLE[role][action]));
+}
+/**
+ * Returns the role-based multiplier for a block sequence.
+ * If any blocker holds MIDDLE_BLOCKER, the whole block has no penalty.
+ */
+export function getBlockRolePenalty(blockerRoles) {
+    const anyMB = blockerRoles.some(roles => roles.includes(RoleEnum.MIDDLE_BLOCKER));
+    return anyMB ? 1.00 : 0.90;
+}

package/dist/esm/src/service/player/role.test.d.ts

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

package/dist/esm/src/service/player/role.test.js

@@ -0,0 +1,194 @@
+import { describe, it, expect } from '@jest/globals';
+import { RarityEnum } from './rarity';
+import { assignRoles, getBlockRolePenalty, getRoleEventPenalty, RoleEnum } from './role';
+// ─── Helpers ──────────────────────────────────────────────────────────────────
+/** Builds a flat PerformanceStats where every stat = value */
+function flatStats(value) {
+    return {
+        setting: value,
+        serve: value,
+        spike: value,
+        quick: value,
+        power: value,
+        awareness: value,
+        attack: value,
+        backAttack: value,
+        reception: value,
+        overhand: value,
+        bump: value,
+        block: value,
+        read: value,
+        commit: value,
+        focus: value,
+        defense: value,
+        stamina: value,
+        reflex: value
+    };
+}
+/** Builds PerformanceStats biased toward setting (SETTER archetype) */
+function setterStats() {
+    return { ...flatStats(20), setting: 90, overhand: 80, awareness: 70, attack: 65 };
+}
+// ─── assignRoles ──────────────────────────────────────────────────────────────
+describe('assignRoles()', () => {
+    const ITERATIONS = 2000;
+    it.each([
+        [RarityEnum.COMMON, 1, 2],
+        [RarityEnum.RARE, 1, 3],
+        [RarityEnum.LEGENDARY, 1, 4],
+        [RarityEnum.MYTHIC, 2, 4],
+        [RarityEnum.SPECIAL, 3, 5]
+    ])('%s: role count always within [%i, %i]', (rarity, min, max) => {
+        const stats = flatStats(50);
+        for (let i = 0; i < ITERATIONS; i++) {
+            const roles = assignRoles(stats, rarity);
+            expect(roles.length).toBeGreaterThanOrEqual(min);
+            expect(roles.length).toBeLessThanOrEqual(max);
+        }
+    });
+    it('primary role is always the highest-scoring role', () => {
+        const stats = setterStats();
+        for (let i = 0; i < 200; i++) {
+            const roles = assignRoles(stats, RarityEnum.LEGENDARY);
+            expect(roles[0]).toBe(RoleEnum.SETTER);
+        }
+    });
+    it('MYTHIC player always gets at least 2 roles', () => {
+        const stats = flatStats(50);
+        for (let i = 0; i < ITERATIONS; i++) {
+            const roles = assignRoles(stats, RarityEnum.MYTHIC);
+            expect(roles.length).toBeGreaterThanOrEqual(2);
+        }
+    });
+    it('SPECIAL player always gets at least 3 roles', () => {
+        const stats = flatStats(50);
+        for (let i = 0; i < ITERATIONS; i++) {
+            const roles = assignRoles(stats, RarityEnum.SPECIAL);
+            expect(roles.length).toBeGreaterThanOrEqual(3);
+        }
+    });
+    it('roles are unique (no duplicates)', () => {
+        const stats = flatStats(50);
+        for (let i = 0; i < 500; i++) {
+            const roles = assignRoles(stats, RarityEnum.SPECIAL);
+            expect(new Set(roles).size).toBe(roles.length);
+        }
+    });
+    it('each role appears at most once', () => {
+        const allRoles = Object.values(RoleEnum);
+        for (let i = 0; i < 500; i++) {
+            const roles = assignRoles(flatStats(50), RarityEnum.SPECIAL);
+            allRoles.forEach(role => {
+                expect(roles.filter(r => r === role).length).toBeLessThanOrEqual(1);
+            });
+        }
+    });
+});
+// ─── getRoleEventPenalty ──────────────────────────────────────────────────────
+describe('getRoleEventPenalty()', () => {
+    // ── reception ──
+    describe('reception', () => {
+        it('LIBERO has no penalty (1.00)', () => {
+            expect(getRoleEventPenalty([RoleEnum.LIBERO], 'reception')).toBeCloseTo(1.00);
+        });
+        it('OUTSIDE_HITTER has 5% penalty (0.95)', () => {
+            expect(getRoleEventPenalty([RoleEnum.OUTSIDE_HITTER], 'reception')).toBeCloseTo(0.95);
+        });
+        it('SETTER has 8% penalty (0.92)', () => {
+            expect(getRoleEventPenalty([RoleEnum.SETTER], 'reception')).toBeCloseTo(0.92);
+        });
+        it('OPPOSITE_HITTER has 8% penalty (0.92)', () => {
+            expect(getRoleEventPenalty([RoleEnum.OPPOSITE_HITTER], 'reception')).toBeCloseTo(0.92);
+        });
+        it('MIDDLE_BLOCKER has full 15% penalty (0.85)', () => {
+            expect(getRoleEventPenalty([RoleEnum.MIDDLE_BLOCKER], 'reception')).toBeCloseTo(0.85);
+        });
+    });
+    // ── set ──
+    describe('set', () => {
+        it('SETTER has no penalty (1.00)', () => {
+            expect(getRoleEventPenalty([RoleEnum.SETTER], 'set')).toBeCloseTo(1.00);
+        });
+        it('LIBERO has 2% penalty (0.98)', () => {
+            expect(getRoleEventPenalty([RoleEnum.LIBERO], 'set')).toBeCloseTo(0.98);
+        });
+        it('OUTSIDE_HITTER has 5% penalty (0.95)', () => {
+            expect(getRoleEventPenalty([RoleEnum.OUTSIDE_HITTER], 'set')).toBeCloseTo(0.95);
+        });
+        it('OPPOSITE_HITTER has 5% penalty (0.95)', () => {
+            expect(getRoleEventPenalty([RoleEnum.OPPOSITE_HITTER], 'set')).toBeCloseTo(0.95);
+        });
+        it('MIDDLE_BLOCKER has full 10% penalty (0.90)', () => {
+            expect(getRoleEventPenalty([RoleEnum.MIDDLE_BLOCKER], 'set')).toBeCloseTo(0.90);
+        });
+    });
+    // ── spike ──
+    describe('spike', () => {
+        it('OUTSIDE_HITTER has no penalty (1.00)', () => {
+            expect(getRoleEventPenalty([RoleEnum.OUTSIDE_HITTER], 'spike')).toBeCloseTo(1.00);
+        });
+        it('OPPOSITE_HITTER has no penalty (1.00)', () => {
+            expect(getRoleEventPenalty([RoleEnum.OPPOSITE_HITTER], 'spike')).toBeCloseTo(1.00);
+        });
+        it('SETTER has 2% penalty (0.98)', () => {
+            expect(getRoleEventPenalty([RoleEnum.SETTER], 'spike')).toBeCloseTo(0.98);
+        });
+        it('MIDDLE_BLOCKER has 5% penalty (0.95)', () => {
+            expect(getRoleEventPenalty([RoleEnum.MIDDLE_BLOCKER], 'spike')).toBeCloseTo(0.95);
+        });
+        it('LIBERO has full 10% penalty (0.90)', () => {
+            expect(getRoleEventPenalty([RoleEnum.LIBERO], 'spike')).toBeCloseTo(0.90);
+        });
+    });
+    // ── multi-role: best wins ──
+    describe('multi-role selects lowest penalty', () => {
+        it('[MIDDLE_BLOCKER, LIBERO] receiving → LIBERO wins (1.00)', () => {
+            expect(getRoleEventPenalty([RoleEnum.MIDDLE_BLOCKER, RoleEnum.LIBERO], 'reception')).toBeCloseTo(1.00);
+        });
+        it('[MIDDLE_BLOCKER, SETTER] setting → SETTER wins (1.00)', () => {
+            expect(getRoleEventPenalty([RoleEnum.MIDDLE_BLOCKER, RoleEnum.SETTER], 'set')).toBeCloseTo(1.00);
+        });
+        it('[LIBERO, OUTSIDE_HITTER] spiking → OH wins (1.00)', () => {
+            expect(getRoleEventPenalty([RoleEnum.LIBERO, RoleEnum.OUTSIDE_HITTER], 'spike')).toBeCloseTo(1.00);
+        });
+        it('[SETTER, OUTSIDE_HITTER] receiving → OH wins (0.95 over 0.92)', () => {
+            expect(getRoleEventPenalty([RoleEnum.SETTER, RoleEnum.OUTSIDE_HITTER], 'reception')).toBeCloseTo(0.95);
+        });
+    });
+    // ── empty roles fallback ──
+    it('empty roles array falls back to maximum penalty', () => {
+        expect(getRoleEventPenalty([], 'reception')).toBeCloseTo(0.85);
+        expect(getRoleEventPenalty([], 'set')).toBeCloseTo(0.90);
+        expect(getRoleEventPenalty([], 'spike')).toBeCloseTo(0.95);
+    });
+});
+// ─── getBlockRolePenalty ──────────────────────────────────────────────────────
+describe('getBlockRolePenalty()', () => {
+    it('no penalty when any blocker is MIDDLE_BLOCKER (1.00)', () => {
+        expect(getBlockRolePenalty([
+            [RoleEnum.MIDDLE_BLOCKER],
+            [RoleEnum.OUTSIDE_HITTER]
+        ])).toBeCloseTo(1.00);
+    });
+    it('no penalty when all blockers are MB', () => {
+        expect(getBlockRolePenalty([
+            [RoleEnum.MIDDLE_BLOCKER],
+            [RoleEnum.MIDDLE_BLOCKER]
+        ])).toBeCloseTo(1.00);
+    });
+    it('10% penalty when no blocker is MB (0.90)', () => {
+        expect(getBlockRolePenalty([
+            [RoleEnum.OUTSIDE_HITTER],
+            [RoleEnum.SETTER]
+        ])).toBeCloseTo(0.90);
+    });
+    it('10% penalty for single non-MB blocker', () => {
+        expect(getBlockRolePenalty([[RoleEnum.OUTSIDE_HITTER]])).toBeCloseTo(0.90);
+    });
+    it('no penalty if MB is a secondary role of any blocker', () => {
+        expect(getBlockRolePenalty([
+            [RoleEnum.OPPOSITE_HITTER, RoleEnum.MIDDLE_BLOCKER],
+            [RoleEnum.OUTSIDE_HITTER]
+        ])).toBeCloseTo(1.00);
+    });
+});