volleyballsimtypes 0.0.356 → 0.0.358

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

@@ -0,0 +1,196 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const globals_1 = require("@jest/globals");
+const rarity_1 = require("./rarity");
+const role_1 = require("./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 ──────────────────────────────────────────────────────────────
+(0, globals_1.describe)('assignRoles()', () => {
+    const ITERATIONS = 2000;
+    globals_1.it.each([
+        [rarity_1.RarityEnum.COMMON, 1, 2],
+        [rarity_1.RarityEnum.RARE, 1, 3],
+        [rarity_1.RarityEnum.LEGENDARY, 1, 4],
+        [rarity_1.RarityEnum.MYTHIC, 2, 4],
+        [rarity_1.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 = (0, role_1.assignRoles)(stats, rarity);
+            (0, globals_1.expect)(roles.length).toBeGreaterThanOrEqual(min);
+            (0, globals_1.expect)(roles.length).toBeLessThanOrEqual(max);
+        }
+    });
+    (0, globals_1.it)('primary role is always the highest-scoring role', () => {
+        const stats = setterStats();
+        for (let i = 0; i < 200; i++) {
+            const roles = (0, role_1.assignRoles)(stats, rarity_1.RarityEnum.LEGENDARY);
+            (0, globals_1.expect)(roles[0]).toBe(role_1.RoleEnum.SETTER);
+        }
+    });
+    (0, globals_1.it)('MYTHIC player always gets at least 2 roles', () => {
+        const stats = flatStats(50);
+        for (let i = 0; i < ITERATIONS; i++) {
+            const roles = (0, role_1.assignRoles)(stats, rarity_1.RarityEnum.MYTHIC);
+            (0, globals_1.expect)(roles.length).toBeGreaterThanOrEqual(2);
+        }
+    });
+    (0, globals_1.it)('SPECIAL player always gets at least 3 roles', () => {
+        const stats = flatStats(50);
+        for (let i = 0; i < ITERATIONS; i++) {
+            const roles = (0, role_1.assignRoles)(stats, rarity_1.RarityEnum.SPECIAL);
+            (0, globals_1.expect)(roles.length).toBeGreaterThanOrEqual(3);
+        }
+    });
+    (0, globals_1.it)('roles are unique (no duplicates)', () => {
+        const stats = flatStats(50);
+        for (let i = 0; i < 500; i++) {
+            const roles = (0, role_1.assignRoles)(stats, rarity_1.RarityEnum.SPECIAL);
+            (0, globals_1.expect)(new Set(roles).size).toBe(roles.length);
+        }
+    });
+    (0, globals_1.it)('each role appears at most once', () => {
+        const allRoles = Object.values(role_1.RoleEnum);
+        for (let i = 0; i < 500; i++) {
+            const roles = (0, role_1.assignRoles)(flatStats(50), rarity_1.RarityEnum.SPECIAL);
+            allRoles.forEach(role => {
+                (0, globals_1.expect)(roles.filter(r => r === role).length).toBeLessThanOrEqual(1);
+            });
+        }
+    });
+});
+// ─── getRoleEventPenalty ──────────────────────────────────────────────────────
+(0, globals_1.describe)('getRoleEventPenalty()', () => {
+    // ── reception ──
+    (0, globals_1.describe)('reception', () => {
+        (0, globals_1.it)('LIBERO has no penalty (1.00)', () => {
+            (0, globals_1.expect)((0, role_1.getRoleEventPenalty)([role_1.RoleEnum.LIBERO], 'reception')).toBeCloseTo(1.00);
+        });
+        (0, globals_1.it)('OUTSIDE_HITTER has 5% penalty (0.95)', () => {
+            (0, globals_1.expect)((0, role_1.getRoleEventPenalty)([role_1.RoleEnum.OUTSIDE_HITTER], 'reception')).toBeCloseTo(0.95);
+        });
+        (0, globals_1.it)('SETTER has 8% penalty (0.92)', () => {
+            (0, globals_1.expect)((0, role_1.getRoleEventPenalty)([role_1.RoleEnum.SETTER], 'reception')).toBeCloseTo(0.92);
+        });
+        (0, globals_1.it)('OPPOSITE_HITTER has 8% penalty (0.92)', () => {
+            (0, globals_1.expect)((0, role_1.getRoleEventPenalty)([role_1.RoleEnum.OPPOSITE_HITTER], 'reception')).toBeCloseTo(0.92);
+        });
+        (0, globals_1.it)('MIDDLE_BLOCKER has full 15% penalty (0.85)', () => {
+            (0, globals_1.expect)((0, role_1.getRoleEventPenalty)([role_1.RoleEnum.MIDDLE_BLOCKER], 'reception')).toBeCloseTo(0.85);
+        });
+    });
+    // ── set ──
+    (0, globals_1.describe)('set', () => {
+        (0, globals_1.it)('SETTER has no penalty (1.00)', () => {
+            (0, globals_1.expect)((0, role_1.getRoleEventPenalty)([role_1.RoleEnum.SETTER], 'set')).toBeCloseTo(1.00);
+        });
+        (0, globals_1.it)('LIBERO has 2% penalty (0.98)', () => {
+            (0, globals_1.expect)((0, role_1.getRoleEventPenalty)([role_1.RoleEnum.LIBERO], 'set')).toBeCloseTo(0.98);
+        });
+        (0, globals_1.it)('OUTSIDE_HITTER has 5% penalty (0.95)', () => {
+            (0, globals_1.expect)((0, role_1.getRoleEventPenalty)([role_1.RoleEnum.OUTSIDE_HITTER], 'set')).toBeCloseTo(0.95);
+        });
+        (0, globals_1.it)('OPPOSITE_HITTER has 5% penalty (0.95)', () => {
+            (0, globals_1.expect)((0, role_1.getRoleEventPenalty)([role_1.RoleEnum.OPPOSITE_HITTER], 'set')).toBeCloseTo(0.95);
+        });
+        (0, globals_1.it)('MIDDLE_BLOCKER has full 10% penalty (0.90)', () => {
+            (0, globals_1.expect)((0, role_1.getRoleEventPenalty)([role_1.RoleEnum.MIDDLE_BLOCKER], 'set')).toBeCloseTo(0.90);
+        });
+    });
+    // ── spike ──
+    (0, globals_1.describe)('spike', () => {
+        (0, globals_1.it)('OUTSIDE_HITTER has no penalty (1.00)', () => {
+            (0, globals_1.expect)((0, role_1.getRoleEventPenalty)([role_1.RoleEnum.OUTSIDE_HITTER], 'spike')).toBeCloseTo(1.00);
+        });
+        (0, globals_1.it)('OPPOSITE_HITTER has no penalty (1.00)', () => {
+            (0, globals_1.expect)((0, role_1.getRoleEventPenalty)([role_1.RoleEnum.OPPOSITE_HITTER], 'spike')).toBeCloseTo(1.00);
+        });
+        (0, globals_1.it)('SETTER has 2% penalty (0.98)', () => {
+            (0, globals_1.expect)((0, role_1.getRoleEventPenalty)([role_1.RoleEnum.SETTER], 'spike')).toBeCloseTo(0.98);
+        });
+        (0, globals_1.it)('MIDDLE_BLOCKER has 5% penalty (0.95)', () => {
+            (0, globals_1.expect)((0, role_1.getRoleEventPenalty)([role_1.RoleEnum.MIDDLE_BLOCKER], 'spike')).toBeCloseTo(0.95);
+        });
+        (0, globals_1.it)('LIBERO has full 10% penalty (0.90)', () => {
+            (0, globals_1.expect)((0, role_1.getRoleEventPenalty)([role_1.RoleEnum.LIBERO], 'spike')).toBeCloseTo(0.90);
+        });
+    });
+    // ── multi-role: best wins ──
+    (0, globals_1.describe)('multi-role selects lowest penalty', () => {
+        (0, globals_1.it)('[MIDDLE_BLOCKER, LIBERO] receiving → LIBERO wins (1.00)', () => {
+            (0, globals_1.expect)((0, role_1.getRoleEventPenalty)([role_1.RoleEnum.MIDDLE_BLOCKER, role_1.RoleEnum.LIBERO], 'reception')).toBeCloseTo(1.00);
+        });
+        (0, globals_1.it)('[MIDDLE_BLOCKER, SETTER] setting → SETTER wins (1.00)', () => {
+            (0, globals_1.expect)((0, role_1.getRoleEventPenalty)([role_1.RoleEnum.MIDDLE_BLOCKER, role_1.RoleEnum.SETTER], 'set')).toBeCloseTo(1.00);
+        });
+        (0, globals_1.it)('[LIBERO, OUTSIDE_HITTER] spiking → OH wins (1.00)', () => {
+            (0, globals_1.expect)((0, role_1.getRoleEventPenalty)([role_1.RoleEnum.LIBERO, role_1.RoleEnum.OUTSIDE_HITTER], 'spike')).toBeCloseTo(1.00);
+        });
+        (0, globals_1.it)('[SETTER, OUTSIDE_HITTER] receiving → OH wins (0.95 over 0.92)', () => {
+            (0, globals_1.expect)((0, role_1.getRoleEventPenalty)([role_1.RoleEnum.SETTER, role_1.RoleEnum.OUTSIDE_HITTER], 'reception')).toBeCloseTo(0.95);
+        });
+    });
+    // ── empty roles fallback ──
+    (0, globals_1.it)('empty roles array falls back to maximum penalty', () => {
+        (0, globals_1.expect)((0, role_1.getRoleEventPenalty)([], 'reception')).toBeCloseTo(0.85);
+        (0, globals_1.expect)((0, role_1.getRoleEventPenalty)([], 'set')).toBeCloseTo(0.90);
+        (0, globals_1.expect)((0, role_1.getRoleEventPenalty)([], 'spike')).toBeCloseTo(0.95);
+    });
+});
+// ─── getBlockRolePenalty ──────────────────────────────────────────────────────
+(0, globals_1.describe)('getBlockRolePenalty()', () => {
+    (0, globals_1.it)('no penalty when any blocker is MIDDLE_BLOCKER (1.00)', () => {
+        (0, globals_1.expect)((0, role_1.getBlockRolePenalty)([
+            [role_1.RoleEnum.MIDDLE_BLOCKER],
+            [role_1.RoleEnum.OUTSIDE_HITTER]
+        ])).toBeCloseTo(1.00);
+    });
+    (0, globals_1.it)('no penalty when all blockers are MB', () => {
+        (0, globals_1.expect)((0, role_1.getBlockRolePenalty)([
+            [role_1.RoleEnum.MIDDLE_BLOCKER],
+            [role_1.RoleEnum.MIDDLE_BLOCKER]
+        ])).toBeCloseTo(1.00);
+    });
+    (0, globals_1.it)('10% penalty when no blocker is MB (0.90)', () => {
+        (0, globals_1.expect)((0, role_1.getBlockRolePenalty)([
+            [role_1.RoleEnum.OUTSIDE_HITTER],
+            [role_1.RoleEnum.SETTER]
+        ])).toBeCloseTo(0.90);
+    });
+    (0, globals_1.it)('10% penalty for single non-MB blocker', () => {
+        (0, globals_1.expect)((0, role_1.getBlockRolePenalty)([[role_1.RoleEnum.OUTSIDE_HITTER]])).toBeCloseTo(0.90);
+    });
+    (0, globals_1.it)('no penalty if MB is a secondary role of any blocker', () => {
+        (0, globals_1.expect)((0, role_1.getBlockRolePenalty)([
+            [role_1.RoleEnum.OPPOSITE_HITTER, role_1.RoleEnum.MIDDLE_BLOCKER],
+            [role_1.RoleEnum.OUTSIDE_HITTER]
+        ])).toBeCloseTo(1.00);
+    });
+});

package/dist/cjs/src/service/player/schemas/performance-stats.z.d.ts

@@ -0,0 +1,22 @@
+import { z } from 'zod';
+export declare const PerformanceStatsInputSchema: z.ZodObject<{
+    attack: z.ZodNumber;
+    serve: z.ZodNumber;
+    reception: z.ZodNumber;
+    block: z.ZodNumber;
+    setting: z.ZodNumber;
+    defense: z.ZodNumber;
+    spike: z.ZodNumber;
+    quick: z.ZodNumber;
+    power: z.ZodNumber;
+    awareness: z.ZodNumber;
+    backAttack: z.ZodNumber;
+    overhand: z.ZodNumber;
+    bump: z.ZodNumber;
+    read: z.ZodNumber;
+    commit: z.ZodNumber;
+    focus: z.ZodNumber;
+    stamina: z.ZodNumber;
+    reflex: z.ZodNumber;
+}, z.core.$strip>;
+export type PerformanceStatsInput = z.infer<typeof PerformanceStatsInputSchema>;

package/dist/cjs/src/service/player/schemas/performance-stats.z.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PerformanceStatsInputSchema = void 0;
+const zod_1 = require("zod");
+const performance_stats_keys_1 = require("../performance-stats-keys");
+const statValueSchema = zod_1.z.number().int().min(1).max(99);
+const shape = Object.fromEntries(performance_stats_keys_1.performanceStatKeys.map((key) => [key, statValueSchema]));
+exports.PerformanceStatsInputSchema = zod_1.z.object(shape);

package/dist/cjs/src/service/player/schemas/player.z.d.ts

@@ -0,0 +1,147 @@
+import { z } from 'zod';
+import { Country } from '../../country';
+import { RoleEnum } from '../role';
+import { TraitEnum } from '../trait';
+import { RarityEnum } from '../rarity';
+export declare const NameInputSchema: z.ZodObject<{
+    first: z.ZodString;
+    last: z.ZodString;
+}, z.core.$strip>;
+export declare const PlayerInputSchema: z.ZodObject<{
+    id: z.ZodUUID;
+    name: z.ZodObject<{
+        first: z.ZodString;
+        last: z.ZodString;
+    }, z.core.$strip>;
+    country: z.ZodCustom<Country, Country>;
+    stats: z.ZodObject<{
+        attack: z.ZodNumber;
+        serve: z.ZodNumber;
+        reception: z.ZodNumber;
+        block: z.ZodNumber;
+        setting: z.ZodNumber;
+        defense: z.ZodNumber;
+        spike: z.ZodNumber;
+        quick: z.ZodNumber;
+        power: z.ZodNumber;
+        awareness: z.ZodNumber;
+        backAttack: z.ZodNumber;
+        overhand: z.ZodNumber;
+        bump: z.ZodNumber;
+        read: z.ZodNumber;
+        commit: z.ZodNumber;
+        focus: z.ZodNumber;
+        stamina: z.ZodNumber;
+        reflex: z.ZodNumber;
+    }, z.core.$strip>;
+    roles: z.ZodArray<z.ZodEnum<{
+        SETTER: RoleEnum.SETTER;
+        LIBERO: RoleEnum.LIBERO;
+        OUTSIDE_HITTER: RoleEnum.OUTSIDE_HITTER;
+        OPPOSITE_HITTER: RoleEnum.OPPOSITE_HITTER;
+        MIDDLE_BLOCKER: RoleEnum.MIDDLE_BLOCKER;
+    }>>;
+    traits: z.ZodArray<z.ZodEnum<{
+        MASTER_MIND: TraitEnum.MASTER_MIND;
+        MOVING_WALL: TraitEnum.MOVING_WALL;
+        SURPRISE_ATTACK: TraitEnum.SURPRISE_ATTACK;
+        MARKSMAN: TraitEnum.MARKSMAN;
+        METEOR_SERVE: TraitEnum.METEOR_SERVE;
+        VIGOROUS: TraitEnum.VIGOROUS;
+        GUARDIAN: TraitEnum.GUARDIAN;
+        FLOAT_SERVE: TraitEnum.FLOAT_SERVE;
+        DEFENSIVE_SPECIALIST: TraitEnum.DEFENSIVE_SPECIALIST;
+    }>>;
+    rarity: z.ZodEnum<{
+        COMMON: RarityEnum.COMMON;
+        RARE: RarityEnum.RARE;
+        LEGENDARY: RarityEnum.LEGENDARY;
+        MYTHIC: RarityEnum.MYTHIC;
+        SPECIAL: RarityEnum.SPECIAL;
+    }>;
+    boxScores: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        playerId: z.ZodUUID;
+        matchSetId: z.ZodUUID;
+        attack: z.ZodObject<{
+            attempts: z.ZodNumber;
+            kills: z.ZodNumber;
+            errors: z.ZodNumber;
+        }, z.core.$strip>;
+        serve: z.ZodObject<{
+            attempts: z.ZodNumber;
+            aces: z.ZodNumber;
+            errors: z.ZodNumber;
+        }, z.core.$strip>;
+        reception: z.ZodObject<{
+            attempts: z.ZodNumber;
+            perfect: z.ZodNumber;
+            positive: z.ZodNumber;
+            overpasses: z.ZodNumber;
+            errors: z.ZodNumber;
+        }, z.core.$strip>;
+        block: z.ZodObject<{
+            solo: z.ZodNumber;
+            assists: z.ZodNumber;
+            errors: z.ZodNumber;
+            touches: z.ZodNumber;
+        }, z.core.$strip>;
+        setting: z.ZodObject<{
+            assists: z.ZodNumber;
+            errors: z.ZodNumber;
+            pass: z.ZodNumber;
+        }, z.core.$strip>;
+        defense: z.ZodObject<{
+            digs: z.ZodNumber;
+            errors: z.ZodNumber;
+        }, z.core.$strip>;
+        misc: z.ZodObject<{
+            pointsPlayed: z.ZodNumber;
+            pointsWonOnCourt: z.ZodNumber;
+            serveTurns: z.ZodNumber;
+            sideoutOpportunities: z.ZodNumber;
+            successfulSideouts: z.ZodNumber;
+        }, z.core.$strip>;
+    }, z.core.$strip>>>;
+    boxScoreTotals: z.ZodOptional<z.ZodObject<{
+        attack: z.ZodObject<{
+            attempts: z.ZodNumber;
+            kills: z.ZodNumber;
+            errors: z.ZodNumber;
+        }, z.core.$strip>;
+        serve: z.ZodObject<{
+            attempts: z.ZodNumber;
+            aces: z.ZodNumber;
+            errors: z.ZodNumber;
+        }, z.core.$strip>;
+        reception: z.ZodObject<{
+            attempts: z.ZodNumber;
+            perfect: z.ZodNumber;
+            positive: z.ZodNumber;
+            overpasses: z.ZodNumber;
+            errors: z.ZodNumber;
+        }, z.core.$strip>;
+        block: z.ZodObject<{
+            solo: z.ZodNumber;
+            assists: z.ZodNumber;
+            errors: z.ZodNumber;
+            touches: z.ZodNumber;
+        }, z.core.$strip>;
+        setting: z.ZodObject<{
+            assists: z.ZodNumber;
+            errors: z.ZodNumber;
+            pass: z.ZodNumber;
+        }, z.core.$strip>;
+        defense: z.ZodObject<{
+            digs: z.ZodNumber;
+            errors: z.ZodNumber;
+        }, z.core.$strip>;
+        misc: z.ZodObject<{
+            pointsPlayed: z.ZodNumber;
+            pointsWonOnCourt: z.ZodNumber;
+            serveTurns: z.ZodNumber;
+            sideoutOpportunities: z.ZodNumber;
+            successfulSideouts: z.ZodNumber;
+        }, z.core.$strip>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type PlayerInput = z.infer<typeof PlayerInputSchema>;

package/dist/cjs/src/service/player/schemas/player.z.js

@@ -0,0 +1,37 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PlayerInputSchema = exports.NameInputSchema = void 0;
+const zod_1 = require("zod");
+const country_1 = require("../../country");
+const role_1 = require("../role");
+const trait_1 = require("../trait");
+const rarity_1 = require("../rarity");
+const box_score_z_1 = require("../../match/schemas/box-score.z");
+const performance_stats_z_1 = require("./performance-stats.z");
+exports.NameInputSchema = zod_1.z.object({
+    first: zod_1.z.string().trim().min(1),
+    last: zod_1.z.string().trim().min(1)
+});
+const countrySchema = zod_1.z.custom((v) => v instanceof country_1.Country, {
+    message: 'INVALID_COUNTRY_INSTANCE'
+});
+const BoxScoreTotalsInputSchema = zod_1.z.object({
+    attack: box_score_z_1.AttackStatsSchema,
+    serve: box_score_z_1.ServeStatsSchema,
+    reception: box_score_z_1.ReceptionStatsSchema,
+    block: box_score_z_1.BlockStatsSchema,
+    setting: box_score_z_1.SettingStatsSchema,
+    defense: box_score_z_1.DefenseStatsSchema,
+    misc: box_score_z_1.MiscStatsSchema
+});
+exports.PlayerInputSchema = zod_1.z.object({
+    id: zod_1.z.uuid(),
+    name: exports.NameInputSchema,
+    country: countrySchema,
+    stats: performance_stats_z_1.PerformanceStatsInputSchema,
+    roles: zod_1.z.array(zod_1.z.enum(Object.values(role_1.RoleEnum))).min(1),
+    traits: zod_1.z.array(zod_1.z.enum(Object.values(trait_1.TraitEnum))),
+    rarity: zod_1.z.enum(Object.values(rarity_1.RarityEnum)),
+    boxScores: zod_1.z.array(box_score_z_1.BoxScoreInputSchema).optional(),
+    boxScoreTotals: BoxScoreTotalsInputSchema.optional()
+});

package/dist/cjs/src/service/player/stats.d.ts

@@ -0,0 +1,12 @@
+import { PerformanceStats, PerformanceStatsKey } from './performance-stats';
+export declare enum StatsEnum {
+    ATTACK = "ATTACK",
+    SET = "SET",
+    RECEIVE = "RECEIVE",
+    SERVE = "SERVE",
+    BLOCK = "BLOCK",
+    STAMINA = "STAMINA"
+}
+export type Stats = StatsEnum.ATTACK | StatsEnum.SET | StatsEnum.RECEIVE | StatsEnum.SERVE | StatsEnum.BLOCK | StatsEnum.STAMINA;
+export declare function calculateStatScore(performanceStats: PerformanceStats, statName: Stats): number;
+export declare function getMultipliers(statName: Stats, performanceStats?: PerformanceStats): Partial<Record<PerformanceStatsKey, number>>;

package/dist/cjs/src/service/player/stats.js

@@ -0,0 +1,68 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.StatsEnum = void 0;
+exports.calculateStatScore = calculateStatScore;
+exports.getMultipliers = getMultipliers;
+var StatsEnum;
+(function (StatsEnum) {
+    StatsEnum["ATTACK"] = "ATTACK";
+    StatsEnum["SET"] = "SET";
+    StatsEnum["RECEIVE"] = "RECEIVE";
+    StatsEnum["SERVE"] = "SERVE";
+    StatsEnum["BLOCK"] = "BLOCK";
+    StatsEnum["STAMINA"] = "STAMINA";
+})(StatsEnum || (exports.StatsEnum = StatsEnum = {}));
+function calculateStatScore(performanceStats, statName) {
+    const multipliers = getMultipliers(statName, performanceStats);
+    const score = Object.entries(multipliers)
+        .reduce((total, [key, value]) => total + value * performanceStats[key], 0);
+    return Math.round(score);
+}
+function getMultipliers(statName, performanceStats) {
+    switch (statName) {
+        case StatsEnum.ATTACK:
+            return {
+                spike: 0.55,
+                backAttack: 0.1,
+                power: performanceStats == null ? 0.125 : performanceStats.power > performanceStats.quick ? 0.2 : 0.05,
+                quick: performanceStats == null ? 0.125 : performanceStats.quick > performanceStats.power ? 0.2 : 0.05,
+                awareness: 0.05,
+                attack: 0.05
+            };
+        case StatsEnum.SET:
+            return {
+                setting: 0.75,
+                overhand: 0.1,
+                awareness: 0.075,
+                attack: 0.075
+            };
+        case StatsEnum.RECEIVE:
+            return {
+                reception: 0.75,
+                overhand: 0.015,
+                bump: 0.15,
+                focus: 0.015,
+                defense: 0.055,
+                reflex: 0.015
+            };
+        case StatsEnum.SERVE:
+            return {
+                serve: 0.85,
+                awareness: 0.075,
+                attack: 0.075
+            };
+        case StatsEnum.BLOCK:
+            return {
+                block: 0.65,
+                read: performanceStats == null ? 0.125 : performanceStats.read > performanceStats.commit ? 0.2 : 0.05,
+                commit: performanceStats == null ? 0.125 : performanceStats.commit > performanceStats.read ? 0.2 : 0.05,
+                focus: 0.04,
+                defense: 0.04,
+                reflex: 0.02
+            };
+        case StatsEnum.STAMINA:
+            return { stamina: 1 };
+        default:
+            throw new Error('INVALID_STAT');
+    }
+}

package/dist/cjs/src/service/player/stats.test.d.ts

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

package/dist/cjs/src/service/player/stats.test.js

@@ -0,0 +1,133 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const globals_1 = require("@jest/globals");
+const stats_1 = require("./stats");
+const performance_stats_1 = require("./performance-stats");
+const performance_stats_keys_1 = require("./performance-stats-keys");
+// ─── helpers ─────────────────────────────────────────────────────────────────
+/** Builds a PerformanceStats with all keys set to `base`, then applies overrides. */
+function makeStats(base = 50, overrides = {}) {
+    const data = Object.fromEntries(performance_stats_keys_1.performanceStatKeys.map(k => [k, base]));
+    return performance_stats_1.PerformanceStats.create({ ...data, ...overrides });
+}
+// ─── getMultipliers ───────────────────────────────────────────────────────────
+(0, globals_1.describe)('getMultipliers()', () => {
+    (0, globals_1.describe)('ATTACK', () => {
+        (0, globals_1.it)('boosts power weight (0.2) when power > quick', () => {
+            const m = (0, stats_1.getMultipliers)(stats_1.StatsEnum.ATTACK, makeStats(50, { power: 80, quick: 20 }));
+            (0, globals_1.expect)(m.power).toBe(0.2);
+            (0, globals_1.expect)(m.quick).toBe(0.05);
+        });
+        (0, globals_1.it)('boosts quick weight (0.2) when quick > power', () => {
+            const m = (0, stats_1.getMultipliers)(stats_1.StatsEnum.ATTACK, makeStats(50, { quick: 80, power: 20 }));
+            (0, globals_1.expect)(m.quick).toBe(0.2);
+            (0, globals_1.expect)(m.power).toBe(0.05);
+        });
+        (0, globals_1.it)('uses balanced weights (0.125) when performanceStats is omitted', () => {
+            const m = (0, stats_1.getMultipliers)(stats_1.StatsEnum.ATTACK);
+            (0, globals_1.expect)(m.power).toBe(0.125);
+            (0, globals_1.expect)(m.quick).toBe(0.125);
+        });
+        (0, globals_1.it)('multipliers sum to 1 when power > quick', () => {
+            const m = (0, stats_1.getMultipliers)(stats_1.StatsEnum.ATTACK, makeStats(50, { power: 80, quick: 20 }));
+            const total = Object.values(m).reduce((s, v) => s + (v ?? 0), 0);
+            (0, globals_1.expect)(total).toBeCloseTo(1, 10);
+        });
+    });
+    (0, globals_1.describe)('SET', () => {
+        (0, globals_1.it)('multipliers sum to 1', () => {
+            const m = (0, stats_1.getMultipliers)(stats_1.StatsEnum.SET);
+            const total = Object.values(m).reduce((s, v) => s + (v ?? 0), 0);
+            (0, globals_1.expect)(total).toBeCloseTo(1, 10);
+        });
+        (0, globals_1.it)('setting has the highest weight (0.75)', () => {
+            const m = (0, stats_1.getMultipliers)(stats_1.StatsEnum.SET);
+            const max = Math.max(...Object.values(m).map(v => v ?? 0));
+            (0, globals_1.expect)(m.setting).toBe(max);
+        });
+    });
+    (0, globals_1.describe)('RECEIVE', () => {
+        (0, globals_1.it)('multipliers sum to 1', () => {
+            const m = (0, stats_1.getMultipliers)(stats_1.StatsEnum.RECEIVE);
+            const total = Object.values(m).reduce((s, v) => s + (v ?? 0), 0);
+            (0, globals_1.expect)(total).toBeCloseTo(1, 10);
+        });
+        (0, globals_1.it)('reception has the highest weight (0.75)', () => {
+            const m = (0, stats_1.getMultipliers)(stats_1.StatsEnum.RECEIVE);
+            const max = Math.max(...Object.values(m).map(v => v ?? 0));
+            (0, globals_1.expect)(m.reception).toBe(max);
+        });
+    });
+    (0, globals_1.describe)('SERVE', () => {
+        (0, globals_1.it)('multipliers sum to 1', () => {
+            const m = (0, stats_1.getMultipliers)(stats_1.StatsEnum.SERVE);
+            const total = Object.values(m).reduce((s, v) => s + (v ?? 0), 0);
+            (0, globals_1.expect)(total).toBeCloseTo(1, 10);
+        });
+        (0, globals_1.it)('serve has the highest weight (0.85)', () => {
+            const m = (0, stats_1.getMultipliers)(stats_1.StatsEnum.SERVE);
+            const max = Math.max(...Object.values(m).map(v => v ?? 0));
+            (0, globals_1.expect)(m.serve).toBe(max);
+        });
+    });
+    (0, globals_1.describe)('BLOCK', () => {
+        (0, globals_1.it)('boosts read weight (0.2) when read > commit', () => {
+            const m = (0, stats_1.getMultipliers)(stats_1.StatsEnum.BLOCK, makeStats(50, { read: 90, commit: 10 }));
+            (0, globals_1.expect)(m.read).toBe(0.2);
+            (0, globals_1.expect)(m.commit).toBe(0.05);
+        });
+        (0, globals_1.it)('boosts commit weight (0.2) when commit > read', () => {
+            const m = (0, stats_1.getMultipliers)(stats_1.StatsEnum.BLOCK, makeStats(50, { commit: 90, read: 10 }));
+            (0, globals_1.expect)(m.commit).toBe(0.2);
+            (0, globals_1.expect)(m.read).toBe(0.05);
+        });
+        (0, globals_1.it)('uses balanced weights (0.125) when performanceStats is omitted', () => {
+            const m = (0, stats_1.getMultipliers)(stats_1.StatsEnum.BLOCK);
+            (0, globals_1.expect)(m.read).toBe(0.125);
+            (0, globals_1.expect)(m.commit).toBe(0.125);
+        });
+        (0, globals_1.it)('multipliers sum to 1 when read > commit', () => {
+            const m = (0, stats_1.getMultipliers)(stats_1.StatsEnum.BLOCK, makeStats(50, { read: 90, commit: 10 }));
+            const total = Object.values(m).reduce((s, v) => s + (v ?? 0), 0);
+            (0, globals_1.expect)(total).toBeCloseTo(1, 10);
+        });
+    });
+    (0, globals_1.describe)('STAMINA', () => {
+        (0, globals_1.it)('returns exactly { stamina: 1 }', () => {
+            (0, globals_1.expect)((0, stats_1.getMultipliers)(stats_1.StatsEnum.STAMINA)).toEqual({ stamina: 1 });
+        });
+    });
+});
+// ─── calculateStatScore ───────────────────────────────────────────────────────
+(0, globals_1.describe)('calculateStatScore()', () => {
+    (0, globals_1.it)('STAMINA score equals the stamina stat value (weight 1.0)', () => {
+        (0, globals_1.expect)((0, stats_1.calculateStatScore)(makeStats(1, { stamina: 77 }), stats_1.StatsEnum.STAMINA)).toBe(77);
+    });
+    (0, globals_1.it)('SET score equals stat value when all stats are uniform (multipliers sum to 1)', () => {
+        // setting*0.75 + overhand*0.1 + awareness*0.075 + attack*0.075 = s * 1.0
+        (0, globals_1.expect)((0, stats_1.calculateStatScore)(makeStats(50), stats_1.StatsEnum.SET)).toBe(50);
+    });
+    (0, globals_1.it)('SERVE score equals stat value when all stats are uniform (multipliers sum to 1)', () => {
+        // serve*0.85 + awareness*0.075 + attack*0.075 = s * 1.0
+        (0, globals_1.expect)((0, stats_1.calculateStatScore)(makeStats(50), stats_1.StatsEnum.SERVE)).toBe(50);
+    });
+    (0, globals_1.it)('RECEIVE score equals stat value when all stats are uniform (multipliers sum to 1)', () => {
+        // reception*0.75 + overhand*0.015 + bump*0.15 + focus*0.015 + defense*0.055 + reflex*0.015 = s * 1.0
+        (0, globals_1.expect)((0, stats_1.calculateStatScore)(makeStats(50), stats_1.StatsEnum.RECEIVE)).toBe(50);
+    });
+    (0, globals_1.it)('always returns an integer (Math.round applied)', () => {
+        const score = (0, stats_1.calculateStatScore)(makeStats(50), stats_1.StatsEnum.SERVE);
+        (0, globals_1.expect)(Number.isInteger(score)).toBe(true);
+    });
+    (0, globals_1.it)('returns a higher score for a player with better relevant stats', () => {
+        const weak = (0, stats_1.calculateStatScore)(makeStats(20), stats_1.StatsEnum.SERVE);
+        const strong = (0, stats_1.calculateStatScore)(makeStats(80), stats_1.StatsEnum.SERVE);
+        (0, globals_1.expect)(strong).toBeGreaterThan(weak);
+    });
+    (0, globals_1.it)('SERVE: serve=99 dominates, contributing 0.85 of the total', () => {
+        // All other serve-relevant stats at 1: awareness=1, attack=1
+        // score ≈ 99*0.85 + 1*0.075 + 1*0.075 = 84.15 + 0.15 = 84.3 → 84
+        const stats = makeStats(1, { serve: 99 });
+        (0, globals_1.expect)((0, stats_1.calculateStatScore)(stats, stats_1.StatsEnum.SERVE)).toBe(84);
+    });
+});