volleyballsimtypes 0.0.359 → 0.0.361

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

@@ -0,0 +1,75 @@
+import { statCapsJSON } from '../../stat-config';
+import { RarityEnum } from './rarity';
+import { performanceStatKeys } from './performance-stats';
+import { getMultipliers } from './stats';
+const CURVE_BASE = 100;
+const CURVE_SCALAR = 0.098;
+const CURVE_EXPONENT = 1.5;
+const statCaps = statCapsJSON;
+export function getStatCap(rarity) {
+    const entry = statCaps.find(e => e.rarity === rarity);
+    if (entry == null)
+        throw new Error(`UNKNOWN_RARITY: ${rarity}`);
+    return entry.cap;
+}
+export function getRarityMultiplier(rarity) {
+    const entry = statCaps.find(e => e.rarity === rarity);
+    if (entry == null)
+        throw new Error(`UNKNOWN_RARITY: ${rarity}`);
+    return entry.rarityMultiplier;
+}
+export function getImprovementThreshold(statTotal, rarity) {
+    const rarityMultiplier = getRarityMultiplier(rarity);
+    const raw = CURVE_BASE + CURVE_SCALAR * Math.pow(Math.max(0, statTotal - 6), CURVE_EXPONENT);
+    return Math.round(raw / rarityMultiplier);
+}
+const COACH_MULTIPLIERS = {
+    [RarityEnum.COMMON]: 2.0,
+    [RarityEnum.RARE]: 1.5,
+    [RarityEnum.LEGENDARY]: 1.0,
+    [RarityEnum.MYTHIC]: 0.85,
+    [RarityEnum.SPECIAL]: 0.65
+};
+export function getCoachMultiplier(rarity) {
+    return COACH_MULTIPLIERS[rarity] ?? 1.0;
+}
+const KEY_TO_COLUMN = {
+    setting: 'setting',
+    serve: 'serve',
+    spike: 'spike',
+    quick: 'quick',
+    power: 'power',
+    awareness: 'awareness',
+    attack: 'attack',
+    backAttack: 'back_attack',
+    reception: 'reception',
+    overhand: 'overhand',
+    bump: 'bump',
+    block: 'block',
+    read: 'read',
+    commit: 'commit',
+    focus: 'focus',
+    defense: 'defense',
+    stamina: 'stamina',
+    reflex: 'reflex'
+};
+export function selectImprovableStat(rarity, trainingFocus, currentStats) {
+    const cap = getStatCap(rarity);
+    const multipliers = getMultipliers(trainingFocus);
+    const focusPool = [];
+    const fallbackPool = [];
+    for (const key of performanceStatKeys) {
+        const col = KEY_TO_COLUMN[key];
+        if ((currentStats[col] ?? 0) >= cap)
+            continue;
+        fallbackPool.push(col);
+        if ((multipliers[key] ?? 0) > 0)
+            focusPool.push(col);
+    }
+    if (focusPool.length > 0) {
+        return focusPool[Math.floor(Math.random() * focusPool.length)];
+    }
+    if (fallbackPool.length === 0)
+        return null;
+    return fallbackPool[Math.floor(Math.random() * fallbackPool.length)];
+}

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

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

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

@@ -0,0 +1,142 @@
+import { describe, it, expect } from '@jest/globals';
+import { RarityEnum } from './rarity';
+import { getStatCap, getRarityMultiplier, getImprovementThreshold, getCoachMultiplier, selectImprovableStat } from './improvement';
+import { StatsEnum } from './stats';
+// ─── getStatCap ───────────────────────────────────────────────────────────────
+describe('getStatCap()', () => {
+    it.each([
+        [RarityEnum.COMMON, 59],
+        [RarityEnum.RARE, 69],
+        [RarityEnum.LEGENDARY, 79],
+        [RarityEnum.MYTHIC, 89],
+        [RarityEnum.SPECIAL, 99]
+    ])('%s → cap %i', (rarity, expected) => {
+        expect(getStatCap(rarity)).toBe(expected);
+    });
+    it('throws UNKNOWN_RARITY for an unrecognised rarity string', () => {
+        expect(() => getStatCap('DIVINE')).toThrow('UNKNOWN_RARITY');
+    });
+});
+// ─── getRarityMultiplier ──────────────────────────────────────────────────────
+describe('getRarityMultiplier()', () => {
+    it.each([
+        [RarityEnum.COMMON, 1.0],
+        [RarityEnum.RARE, 1.15],
+        [RarityEnum.LEGENDARY, 1.3],
+        [RarityEnum.MYTHIC, 1.5],
+        [RarityEnum.SPECIAL, 1.75]
+    ])('%s → multiplier %f', (rarity, expected) => {
+        expect(getRarityMultiplier(rarity)).toBeCloseTo(expected, 5);
+    });
+    it('throws UNKNOWN_RARITY for an unrecognised rarity string', () => {
+        expect(() => getRarityMultiplier('DIVINE')).toThrow('UNKNOWN_RARITY');
+    });
+});
+// ─── getImprovementThreshold ──────────────────────────────────────────────────
+describe('getImprovementThreshold()', () => {
+    it('at statTotal=6 the curve exponent term is 0 → threshold = round(100 / rarityMultiplier)', () => {
+        // COMMON (multiplier 1.0): round(100 / 1.0) = 100
+        expect(getImprovementThreshold(6, RarityEnum.COMMON)).toBe(100);
+        // LEGENDARY (multiplier 1.3): round(100 / 1.3) = 77
+        expect(getImprovementThreshold(6, RarityEnum.LEGENDARY)).toBe(Math.round(100 / 1.3));
+    });
+    it('threshold increases as statTotal grows beyond 6', () => {
+        const low = getImprovementThreshold(10, RarityEnum.COMMON);
+        const high = getImprovementThreshold(50, RarityEnum.COMMON);
+        expect(high).toBeGreaterThan(low);
+    });
+    it('higher rarity multiplier yields lower threshold (easier improvement)', () => {
+        const common = getImprovementThreshold(30, RarityEnum.COMMON);
+        const legendary = getImprovementThreshold(30, RarityEnum.LEGENDARY);
+        expect(legendary).toBeLessThan(common);
+    });
+    it('returns an integer (Math.round applied)', () => {
+        expect(Number.isInteger(getImprovementThreshold(20, RarityEnum.RARE))).toBe(true);
+    });
+});
+// ─── getCoachMultiplier ───────────────────────────────────────────────────────
+describe('getCoachMultiplier()', () => {
+    it.each([
+        [RarityEnum.COMMON, 2.0],
+        [RarityEnum.RARE, 1.5],
+        [RarityEnum.LEGENDARY, 1.0],
+        [RarityEnum.MYTHIC, 0.85],
+        [RarityEnum.SPECIAL, 0.65]
+    ])('%s → %f', (rarity, expected) => {
+        expect(getCoachMultiplier(rarity)).toBeCloseTo(expected, 10);
+    });
+    it('higher rarity → lower coach multiplier (rarer players improve more slowly)', () => {
+        expect(getCoachMultiplier(RarityEnum.COMMON)).toBeGreaterThan(getCoachMultiplier(RarityEnum.LEGENDARY));
+    });
+});
+// ─── selectImprovableStat ─────────────────────────────────────────────────────
+/** Builds a stat record (DB column names) with every value set to `value`. */
+function allStats(value) {
+    return {
+        setting: value,
+        serve: value,
+        spike: value,
+        quick: value,
+        power: value,
+        awareness: value,
+        attack: value,
+        back_attack: value,
+        reception: value,
+        overhand: value,
+        bump: value,
+        block: value,
+        read: value,
+        commit: value,
+        focus: value,
+        defense: value,
+        stamina: value,
+        reflex: value
+    };
+}
+describe('selectImprovableStat()', () => {
+    it('returns null when every stat is at or above the rarity cap', () => {
+        const cap = getStatCap(RarityEnum.COMMON); // 59
+        expect(selectImprovableStat(RarityEnum.COMMON, StatsEnum.ATTACK, allStats(cap))).toBeNull();
+    });
+    it('returns a stat from the SERVE focus pool (serve, awareness, attack)', () => {
+        const focusPool = new Set(['serve', 'awareness', 'attack']);
+        const stats = allStats(1);
+        // Run many times to confirm we never escape the focus pool
+        for (let i = 0; i < 100; i++) {
+            const result = selectImprovableStat(RarityEnum.COMMON, StatsEnum.SERVE, stats);
+            expect(result).not.toBeNull();
+            expect(focusPool.has(result)).toBe(true);
+        }
+    });
+    it('returns a stat from the RECEIVE focus pool (reception, overhand, bump, focus, defense, reflex)', () => {
+        const focusPool = new Set(['reception', 'overhand', 'bump', 'focus', 'defense', 'reflex']);
+        const stats = allStats(1);
+        for (let i = 0; i < 100; i++) {
+            const result = selectImprovableStat(RarityEnum.COMMON, StatsEnum.RECEIVE, stats);
+            expect(result).not.toBeNull();
+            expect(focusPool.has(result)).toBe(true);
+        }
+    });
+    it('falls back to any improvable stat when all focus-pool stats are capped', () => {
+        const cap = getStatCap(RarityEnum.COMMON);
+        // Cap the SERVE focus stats: serve, awareness, attack
+        const stats = { ...allStats(1), serve: cap, awareness: cap, attack: cap };
+        for (let i = 0; i < 50; i++) {
+            const result = selectImprovableStat(RarityEnum.COMMON, StatsEnum.SERVE, stats);
+            expect(result).not.toBeNull();
+            // Must never return one of the capped focus stats
+            expect(['serve', 'awareness', 'attack']).not.toContain(result);
+        }
+    });
+    it('returns a string (DB column name) not a PerformanceStatsKey', () => {
+        const stats = allStats(1);
+        const result = selectImprovableStat(RarityEnum.COMMON, StatsEnum.ATTACK, stats);
+        // back_attack is the DB column for backAttack — verify the column naming convention
+        if (result === 'back_attack') {
+            expect(result).toBe('back_attack');
+        }
+        else {
+            expect(typeof result).toBe('string');
+        }
+    });
+});

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

@@ -0,0 +1,9 @@
+export * from './player';
+export * from './improvement';
+export * from './decline';
+export * from './player-generator';
+export * from './performance-stats';
+export * from './trait';
+export * from './rarity';
+export * from './role';
+export * from './stats';

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

@@ -0,0 +1,9 @@
+export * from './player';
+export * from './improvement';
+export * from './decline';
+export * from './player-generator';
+export * from './performance-stats';
+export * from './trait';
+export * from './rarity';
+export * from './role';
+export * from './stats';

package/dist/esm/src/service/player/performance-stats-keys.d.ts

@@ -0,0 +1,2 @@
+export declare const performanceStatKeys: readonly ["setting", "serve", "spike", "quick", "power", "awareness", "attack", "backAttack", "reception", "overhand", "bump", "block", "read", "commit", "focus", "defense", "stamina", "reflex"];
+export type PerformanceStatsKey = typeof performanceStatKeys[number];

package/dist/esm/src/service/player/performance-stats-keys.js

@@ -0,0 +1,2 @@
+export const performanceStatKeys = ['setting', 'serve', 'spike', 'quick', 'power', 'awareness', 'attack', 'backAttack',
+    'reception', 'overhand', 'bump', 'block', 'read', 'commit', 'focus', 'defense', 'stamina', 'reflex'];

package/dist/esm/src/service/player/performance-stats.d.ts

@@ -0,0 +1,12 @@
+import { PerformanceStatsKey, performanceStatKeys } from './performance-stats-keys';
+export { performanceStatKeys };
+export type { PerformanceStatsKey };
+export type PerformanceStatsParams = Record<PerformanceStatsKey, number>;
+export interface PerformanceStats extends PerformanceStatsParams {
+}
+export declare class PerformanceStats {
+    static create(input: unknown): PerformanceStats;
+    private constructor();
+    static fromAverage(avg: number): PerformanceStats;
+    toString(): string;
+}

package/dist/esm/src/service/player/performance-stats.js

@@ -0,0 +1,31 @@
+import { PerformanceStatsInputSchema } from './schemas/performance-stats.z';
+import { performanceStatKeys } from './performance-stats-keys';
+export { performanceStatKeys };
+export class PerformanceStats {
+    static create(input) {
+        const result = PerformanceStatsInputSchema.safeParse(input);
+        if (!result.success) {
+            const received = (() => {
+                try {
+                    return JSON.stringify(input);
+                }
+                catch {
+                    return String(input);
+                }
+            })();
+            throw new Error(`INVALID_PERFORMANCE_STATS: ${result.error.message}. RECEIVED=${received}`);
+        }
+        return new PerformanceStats(result.data);
+    }
+    constructor(opts) {
+        Object.assign(this, opts);
+    }
+    static fromAverage(avg) {
+        const opts = Object.fromEntries(performanceStatKeys.map((key) => [key, avg]));
+        return PerformanceStats.create(opts);
+    }
+    toString() {
+        return performanceStatKeys.map((key) => `${key}: ${this[key]}`)
+            .join(', ');
+    }
+}

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

@@ -0,0 +1,36 @@
+import { Rarity } from './rarity';
+import { Role } from './role';
+import { Country } from '../country';
+import { Player } from './player';
+export interface PityState {
+    legendaryPity: number;
+    mythicPity: number;
+    specialPity: number;
+}
+export interface RollResult {
+    rarity: Rarity;
+    pity: PityState;
+}
+export interface GachaPullConfig {
+    special: number;
+    mythic: number;
+    legendary: number;
+    rare: number;
+    applyLegendaryPity: boolean;
+    applyMythicPity: boolean;
+    applySpecialPity: boolean;
+    accumulateLegendaryPity: boolean;
+    accumulateMythicPity: boolean;
+    accumulateSpecialPity: boolean;
+}
+export declare const NORMAL_PULL_CONFIG: GachaPullConfig;
+export declare const QUALIFIER_PULL_CONFIG: GachaPullConfig;
+export declare const TOURNAMENT_PULL_CONFIG: GachaPullConfig;
+export declare function rollRarity(pity: PityState, config?: GachaPullConfig): RollResult;
+export declare class PlayerGenerator {
+    private constructor();
+    private static generatePerformance;
+    static generatePlayer(country: Country, _rarity?: Rarity, role?: Role, maxTraits?: boolean): Player;
+    static generatePlayers(count: number, countries: Country[]): Player[];
+}
+export declare function pickPlayerCountry(teamCountry: Country, allCountries: Country[]): Country;

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

@@ -0,0 +1,254 @@
+import { v4 as uuidv4 } from 'uuid';
+import { randomInt } from 'node:crypto';
+import { RarityEnum, RarityRanges } from './rarity';
+import { performanceStatKeys, PerformanceStats } from './performance-stats';
+import { assignRoles } from './role';
+import { getMultipliers, StatsEnum } from './stats';
+import { rolesJSON } from '../../stat-config';
+import { shuffle, generatePlayerName } from '../utils';
+import { Player } from './player';
+import { assignTraits } from './trait';
+import { declineProfiles } from './decline';
+const LEGENDARY_PITY_STEP = 0.004;
+const MYTHIC_PITY_STEP = 0.00001;
+const SPECIAL_PITY_STEP = 0.000005;
+// Used for world/bot player generation — full rarity range
+const WORLD_PULL_CONFIG = {
+    special: 0.0003,
+    mythic: 0.004,
+    legendary: 0.021,
+    rare: 0.25,
+    applyLegendaryPity: true,
+    applyMythicPity: true,
+    applySpecialPity: true,
+    accumulateLegendaryPity: true,
+    accumulateMythicPity: true,
+    accumulateSpecialPity: true
+};
+// Normal gacha (x1 / x10): COMMON–MYTHIC, no special
+export const NORMAL_PULL_CONFIG = {
+    special: 0,
+    mythic: 0.004,
+    legendary: 0.021,
+    rare: 0.25,
+    applyLegendaryPity: true,
+    applyMythicPity: true,
+    applySpecialPity: false,
+    accumulateLegendaryPity: true,
+    accumulateMythicPity: true,
+    accumulateSpecialPity: false
+};
+// Qualifier gacha (x10 per match): RARE–SPECIAL
+export const QUALIFIER_PULL_CONFIG = {
+    special: 0.003,
+    mythic: 0.01,
+    legendary: 0.10,
+    rare: 0.887,
+    applyLegendaryPity: true,
+    applyMythicPity: true,
+    applySpecialPity: true,
+    accumulateLegendaryPity: true,
+    accumulateMythicPity: true,
+    accumulateSpecialPity: true
+};
+// Tournament gacha (x5 per match): LEGENDARY–SPECIAL, no legendary pity (floor is legendary)
+export const TOURNAMENT_PULL_CONFIG = {
+    special: 0.01,
+    mythic: 0.04,
+    legendary: 0.95,
+    rare: 0,
+    applyLegendaryPity: false,
+    applyMythicPity: true,
+    applySpecialPity: true,
+    accumulateLegendaryPity: false,
+    accumulateMythicPity: true,
+    accumulateSpecialPity: true
+};
+export function rollRarity(pity, config = WORLD_PULL_CONFIG) {
+    const roll = Math.random();
+    const tSpecial = config.special + (config.applySpecialPity ? pity.specialPity : 0);
+    const tMythic = tSpecial + config.mythic + (config.applyMythicPity ? pity.mythicPity : 0);
+    const tLegendary = tMythic + config.legendary + (config.applyLegendaryPity ? pity.legendaryPity : 0);
+    const tRare = tLegendary + config.rare;
+    let rarity;
+    if (roll < tSpecial) {
+        rarity = RarityEnum.SPECIAL;
+    }
+    else if (roll < tMythic) {
+        rarity = RarityEnum.MYTHIC;
+    }
+    else if (roll < tLegendary) {
+        rarity = RarityEnum.LEGENDARY;
+    }
+    else if (roll < tRare) {
+        rarity = RarityEnum.RARE;
+    }
+    else {
+        rarity = RarityEnum.COMMON;
+    }
+    const hitLegendaryPlus = rarity === RarityEnum.LEGENDARY || rarity === RarityEnum.MYTHIC || rarity === RarityEnum.SPECIAL;
+    const hitMythicPlus = rarity === RarityEnum.MYTHIC || rarity === RarityEnum.SPECIAL;
+    const updatedPity = {
+        legendaryPity: !config.accumulateLegendaryPity
+            ? pity.legendaryPity
+            : hitLegendaryPlus ? 0 : pity.legendaryPity + LEGENDARY_PITY_STEP,
+        mythicPity: !config.accumulateMythicPity
+            ? pity.mythicPity
+            : hitMythicPlus ? 0 : pity.mythicPity + MYTHIC_PITY_STEP,
+        specialPity: !config.accumulateSpecialPity
+            ? pity.specialPity
+            : rarity === RarityEnum.SPECIAL ? 0 : pity.specialPity + SPECIAL_PITY_STEP
+    };
+    return { rarity, pity: updatedPity };
+}
+/* eslint-disable @typescript-eslint/no-extraneous-class */
+export class PlayerGenerator {
+    constructor() { }
+    static generatePerformance(rarity, role) {
+        const ATTACK = getMultipliers(StatsEnum.ATTACK);
+        const SET = getMultipliers(StatsEnum.SET);
+        const RECEIVE = getMultipliers(StatsEnum.RECEIVE);
+        const BLOCK = getMultipliers(StatsEnum.BLOCK);
+        const SERVE = getMultipliers(StatsEnum.SERVE);
+        const STAMINA = getMultipliers(StatsEnum.STAMINA);
+        function buildPerformanceFromRole(weights, minValue, maxValue) {
+            return PerformanceStats.create(Object.fromEntries(performanceStatKeys.map((key) => {
+                if (weights[key] > 0)
+                    return [key, randomInt(minValue, maxValue + 1)];
+                else
+                    return [key, randomInt(RarityRanges.COMMON[0], Math.max(minValue - 1, RarityRanges.COMMON[0] + 1))];
+            })));
+        }
+        switch (rarity) {
+            case RarityEnum.COMMON: {
+                if (role != null) {
+                    const weights = rolesJSON.find(entry => entry.role === role)?.weight;
+                    if (weights != null) {
+                        return buildPerformanceFromRole(weights, RarityRanges.COMMON[0], RarityRanges.COMMON[1]);
+                    }
+                }
+                return PerformanceStats.create(Object.fromEntries(performanceStatKeys.map((key) => [key, Math.round(randomInt(RarityRanges.COMMON[0], RarityRanges.COMMON[1]))])));
+            }
+            case RarityEnum.RARE: {
+                if (role != null) {
+                    const weights = rolesJSON.find(entry => entry.role === role)?.weight;
+                    if (weights != null) {
+                        return buildPerformanceFromRole(weights, RarityRanges.RARE[0], RarityRanges.RARE[1]);
+                    }
+                }
+                const stats = shuffle([ATTACK, SET, SERVE, RECEIVE, BLOCK]);
+                const performance = Object.fromEntries(performanceStatKeys.map((key) => [key, 1]));
+                for (let i = 0; i < 3; i++) {
+                    assignValues(stats[i], RarityRanges.RARE[0], RarityRanges.RARE[1], performance);
+                }
+                for (let i = 3; i < 5; i++) {
+                    assignValues(stats[i], RarityRanges.COMMON[0], RarityRanges.COMMON[1], performance);
+                }
+                assignValues(STAMINA, RarityRanges.COMMON[0], RarityRanges.RARE[1], performance);
+                return PerformanceStats.create(performance);
+            }
+            case RarityEnum.LEGENDARY: {
+                if (role != null) {
+                    const weights = rolesJSON.find(entry => entry.role === role)?.weight;
+                    if (weights != null) {
+                        return buildPerformanceFromRole(weights, RarityRanges.LEGENDARY[0], RarityRanges.LEGENDARY[1]);
+                    }
+                }
+                const s1 = shuffle([ATTACK, SET, RECEIVE, BLOCK]);
+                const s2 = shuffle([SERVE, STAMINA]);
+                const performance = Object.fromEntries(performanceStatKeys.map((key) => [key, 1]));
+                assignValues(s1[0], RarityRanges.LEGENDARY[0], RarityRanges.LEGENDARY[1], performance);
+                for (let i = 1; i < 4; i++) {
+                    assignValues(s1[i], RarityRanges.RARE[0], RarityRanges.RARE[1], performance);
+                }
+                for (let i = 0; i < 2; i++) {
+                    assignValues(s2[i], RarityRanges.COMMON[0], RarityRanges.RARE[1], performance);
+                }
+                return PerformanceStats.create(performance);
+            }
+            case RarityEnum.MYTHIC: {
+                if (role != null) {
+                    const weights = rolesJSON.find(entry => entry.role === role)?.weight;
+                    if (weights != null) {
+                        return buildPerformanceFromRole(weights, RarityRanges.MYTHIC[0], RarityRanges.MYTHIC[1]);
+                    }
+                }
+                const stats = shuffle([ATTACK, SET, RECEIVE, BLOCK]);
+                const performance = Object.fromEntries(performanceStatKeys.map((key) => [key, 1]));
+                assignValues(stats[0], RarityRanges.MYTHIC[0], RarityRanges.MYTHIC[1], performance);
+                assignValues(stats[1], RarityRanges.LEGENDARY[0], RarityRanges.LEGENDARY[1], performance);
+                for (let i = 2; i < 4; i++) {
+                    assignValues(stats[i], RarityRanges.RARE[0], RarityRanges.RARE[1], performance);
+                }
+                assignValues(SERVE, RarityRanges.LEGENDARY[0], RarityRanges.LEGENDARY[1], performance);
+                assignValues(STAMINA, RarityRanges.COMMON[0], RarityRanges.MYTHIC[1], performance);
+                return PerformanceStats.create(performance);
+            }
+            case RarityEnum.SPECIAL: {
+                if (role != null) {
+                    const weights = rolesJSON.find(entry => entry.role === role)?.weight;
+                    if (weights != null) {
+                        return buildPerformanceFromRole(weights, RarityRanges.SPECIAL[0], RarityRanges.SPECIAL[1]);
+                    }
+                }
+                const stats = shuffle([ATTACK, SERVE, SET, RECEIVE, BLOCK]);
+                const performance = Object.fromEntries(performanceStatKeys.map((key) => [key, 1]));
+                assignValues(stats[0], RarityRanges.SPECIAL[0], RarityRanges.SPECIAL[1], performance);
+                for (let i = 1; i < 3; i++) {
+                    assignValues(stats[i], RarityRanges.MYTHIC[0], RarityRanges.MYTHIC[1], performance);
+                }
+                for (let i = 3; i < 5; i++) {
+                    assignValues(stats[i], RarityRanges.LEGENDARY[0], RarityRanges.LEGENDARY[1], performance);
+                }
+                assignValues(STAMINA, RarityRanges.LEGENDARY[0], RarityRanges.SPECIAL[1], performance);
+                return PerformanceStats.create(performance);
+            }
+            default: {
+                throw new Error('INVALID_RARITY');
+            }
+        }
+    }
+    static generatePlayer(country, _rarity, role, maxTraits) {
+        const rarity = _rarity ?? rollRarity({ legendaryPity: 0, mythicPity: 0, specialPity: 0 }).rarity;
+        const name = generatePlayerName(country.locales, 1)[0];
+        const stats = PlayerGenerator.generatePerformance(rarity, role);
+        const roles = assignRoles(stats, rarity);
+        const traits = assignTraits(roles, rarity, maxTraits);
+        const age = randomInt(15, 21);
+        const declineProfile = declineProfiles[randomInt(0, declineProfiles.length)];
+        return Player.create({ id: uuidv4(), name, country, stats, roles, traits, rarity, age, declineProfile });
+    }
+    static generatePlayers(count, countries) {
+        const players = [];
+        for (const country of countries) {
+            for (let i = 0; i < count; i++) {
+                players.push(PlayerGenerator.generatePlayer(country));
+            }
+        }
+        return players;
+    }
+}
+export function pickPlayerCountry(teamCountry, allCountries) {
+    const roll = Math.random();
+    if (roll < 0.60) {
+        return teamCountry;
+    }
+    if (roll < 0.95) {
+        const regionCode = teamCountry.region?.code;
+        const regional = regionCode != null
+            ? allCountries.filter(c => c.region?.code === regionCode && c.id !== teamCountry.id)
+            : [];
+        if (regional.length > 0) {
+            return regional[Math.floor(Math.random() * regional.length)];
+        }
+        return teamCountry;
+    }
+    return allCountries[Math.floor(Math.random() * allCountries.length)];
+}
+function assignValues(stat, low, high, performance) {
+    performanceStatKeys.filter((key) => stat[key] != null && stat[key] > 0)
+        .forEach((key) => {
+        const value = randomInt(low, high);
+        performance[key] = performance[key] < value ? value : performance[key];
+    });
+}

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

@@ -0,0 +1,43 @@
+import { PerformanceStats } from './performance-stats';
+import { Trait } from './trait';
+import { Country } from '../country';
+import { Rarity } from './rarity';
+import { Stats } from './stats';
+import { Role } from './role';
+import { BoxScore, BoxScoreTotals } from '../match';
+import { DeclineProfile } from './decline';
+export declare class Stat {
+    readonly name: Stats;
+    readonly value: number;
+    constructor({ name, value }: {
+        name: Stats;
+        value: number;
+    });
+    toString(): string;
+}
+export declare class Name {
+    readonly first: string;
+    readonly last: string;
+    static create(input: unknown): Name;
+    private constructor();
+    toString(): string;
+}
+export declare class Player {
+    readonly id: string;
+    readonly name: Name;
+    readonly country: Country;
+    readonly stats: PerformanceStats;
+    readonly roles: Role[];
+    readonly traits: Trait[];
+    readonly generalStats: Stat[];
+    readonly rarity: Rarity;
+    readonly age: number;
+    readonly declineProfile: DeclineProfile;
+    readonly boxScores?: BoxScore[];
+    readonly boxScoreTotals?: BoxScoreTotals;
+    static create(input: unknown): Player;
+    private constructor();
+    static sortPlayers(roles: Role[]): (p1: Player, p2: Player) => number;
+    static compareStats(p1: Player, p2: Player): number;
+    toString(): string;
+}