volleyballsimtypes 0.0.359 → 0.0.360

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

@@ -0,0 +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[];
+};

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

@@ -0,0 +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]: [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

@@ -0,0 +1,28 @@
+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

@@ -0,0 +1,74 @@
+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);
+    });
+});

package/dist/esm/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/esm/src/service/player/schemas/performance-stats.z.js

@@ -0,0 +1,5 @@
+import { z } from 'zod';
+import { performanceStatKeys } from '../performance-stats-keys';
+const statValueSchema = z.number().int().min(1).max(99);
+const shape = Object.fromEntries(performanceStatKeys.map((key) => [key, statValueSchema]));
+export const PerformanceStatsInputSchema = z.object(shape);

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

@@ -0,0 +1,155 @@
+import { z } from 'zod';
+import { Country } from '../../country';
+import { RoleEnum } from '../role';
+import { TraitEnum } from '../trait';
+import { RarityEnum } from '../rarity';
+import { DeclineProfileEnum } from '../decline';
+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;
+    }>;
+    age: z.ZodNumber;
+    declineProfile: z.ZodEnum<{
+        PRODIGY: DeclineProfileEnum.PRODIGY;
+        STANDARD: DeclineProfileEnum.STANDARD;
+        VETERAN: DeclineProfileEnum.VETERAN;
+        IRONMAN: DeclineProfileEnum.IRONMAN;
+    }>;
+    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/esm/src/service/player/schemas/player.z.js

@@ -0,0 +1,37 @@
+import { z } from 'zod';
+import { Country } from '../../country';
+import { RoleEnum } from '../role';
+import { TraitEnum } from '../trait';
+import { RarityEnum } from '../rarity';
+import { DeclineProfileEnum } from '../decline';
+import { AttackStatsSchema, BlockStatsSchema, BoxScoreInputSchema, DefenseStatsSchema, MiscStatsSchema, ReceptionStatsSchema, ServeStatsSchema, SettingStatsSchema } from '../../match/schemas/box-score.z';
+import { PerformanceStatsInputSchema } from './performance-stats.z';
+export const NameInputSchema = z.object({
+    first: z.string().trim().min(1),
+    last: z.string().trim().min(1)
+});
+const countrySchema = z.custom((v) => v instanceof Country, {
+    message: 'INVALID_COUNTRY_INSTANCE'
+});
+const BoxScoreTotalsInputSchema = z.object({
+    attack: AttackStatsSchema,
+    serve: ServeStatsSchema,
+    reception: ReceptionStatsSchema,
+    block: BlockStatsSchema,
+    setting: SettingStatsSchema,
+    defense: DefenseStatsSchema,
+    misc: MiscStatsSchema
+});
+export const PlayerInputSchema = z.object({
+    id: z.uuid(),
+    name: NameInputSchema,
+    country: countrySchema,
+    stats: PerformanceStatsInputSchema,
+    roles: z.array(z.enum(Object.values(RoleEnum))).min(1),
+    traits: z.array(z.enum(Object.values(TraitEnum))),
+    rarity: z.enum(Object.values(RarityEnum)),
+    age: z.number().int().min(0),
+    declineProfile: z.enum(Object.values(DeclineProfileEnum)),
+    boxScores: z.array(BoxScoreInputSchema).optional(),
+    boxScoreTotals: BoxScoreTotalsInputSchema.optional()
+});

package/dist/esm/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/esm/src/service/player/stats.js

@@ -0,0 +1,63 @@
+export var StatsEnum;
+(function (StatsEnum) {
+    StatsEnum["ATTACK"] = "ATTACK";
+    StatsEnum["SET"] = "SET";
+    StatsEnum["RECEIVE"] = "RECEIVE";
+    StatsEnum["SERVE"] = "SERVE";
+    StatsEnum["BLOCK"] = "BLOCK";
+    StatsEnum["STAMINA"] = "STAMINA";
+})(StatsEnum || (StatsEnum = {}));
+export 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);
+}
+export 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/esm/src/service/player/stats.test.d.ts

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