volleyballsimtypes 0.0.356 → 0.0.358

package/dist/cjs/src/service/match/vper.js

@@ -0,0 +1,69 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.VPER = void 0;
+const vper_z_1 = require("./schemas/vper.z");
+const WEIGHTS = {
+    // terminal positive
+    ATTACK_KILL: 1.0,
+    SERVE_ACE: 1.0,
+    BLOCK_SOLO: 1.0,
+    BLOCK_ASSIST: 0.5,
+    // creation / continuation
+    SETTING_ASSIST: 0.7,
+    BLOCK_TOUCH: 0.2,
+    DEFENSE_DIG: 0.25,
+    SETTING_PASS: 0.15,
+    // reception quality
+    RECEPTION_PERFECT: 0.35,
+    RECEPTION_POSITIVE: 0.15,
+    RECEPTION_OVERPASS: -0.6,
+    // terminal errors (always point against)
+    TERMINAL_ERROR: -1.0
+};
+class VPER {
+    static create(input) {
+        const result = vper_z_1.VPERInputSchema.safeParse(input);
+        if (!result.success) {
+            throw new Error(`INVALID_VPER: ${result.error.message}. RECEIVED=${(() => { try {
+                return JSON.stringify(input);
+            }
+            catch {
+                return String(input);
+            } })()}`);
+        }
+        return new VPER(result.data);
+    }
+    constructor({ playerId, matchId, value }) {
+        this.matchId = matchId;
+        this.playerId = playerId;
+        this.value = value;
+    }
+    static computeVPERForMatch(boxScores) {
+        let rawSum = 0;
+        let pointsPlayedSum = 0;
+        for (const box of boxScores) {
+            const w = WEIGHTS;
+            const positive = w.ATTACK_KILL * box.attack.kills +
+                w.SERVE_ACE * box.serve.aces +
+                w.BLOCK_SOLO * box.block.solo +
+                w.BLOCK_ASSIST * box.block.assists +
+                w.SETTING_ASSIST * box.setting.assists +
+                w.BLOCK_TOUCH * box.block.touches +
+                w.DEFENSE_DIG * box.defense.digs +
+                w.SETTING_PASS * box.setting.pass +
+                w.RECEPTION_PERFECT * box.reception.perfect +
+                w.RECEPTION_POSITIVE * box.reception.positive;
+            const negative = w.RECEPTION_OVERPASS * box.reception.overpasses +
+                w.TERMINAL_ERROR * (box.attack.errors +
+                    box.serve.errors +
+                    box.reception.errors +
+                    box.defense.errors +
+                    box.block.errors +
+                    box.setting.errors);
+            rawSum += positive + negative;
+            pointsPlayedSum += box.misc.pointsPlayed;
+        }
+        return 100 * rawSum / Math.max(1, pointsPlayedSum);
+    }
+}
+exports.VPER = VPER;

package/dist/cjs/src/service/match/vper.test.d.ts

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

package/dist/cjs/src/service/match/vper.test.js

@@ -0,0 +1,108 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const globals_1 = require("@jest/globals");
+const uuid_1 = require("uuid");
+const vper_1 = require("./vper");
+const box_score_1 = require("./box-score");
+// ─── helpers ─────────────────────────────────────────────────────────────────
+function makeBox() {
+    return box_score_1.BoxScore.createEmptyBoxScore((0, uuid_1.v4)(), (0, uuid_1.v4)());
+}
+// ─── VPER.computeVPERForMatch ─────────────────────────────────────────────────
+(0, globals_1.describe)('VPER.computeVPERForMatch()', () => {
+    (0, globals_1.it)('returns 0 when box score list is empty', () => {
+        (0, globals_1.expect)(vper_1.VPER.computeVPERForMatch([])).toBe(0);
+    });
+    (0, globals_1.it)('returns 0 for a single all-zero box score', () => {
+        (0, globals_1.expect)(vper_1.VPER.computeVPERForMatch([makeBox()])).toBe(0);
+    });
+    (0, globals_1.it)('uses max(1, pointsPlayed) to avoid division by zero', () => {
+        const box = makeBox();
+        box.attack.kills = 1;
+        // pointsPlayed remains 0 → denominator becomes 1
+        // 100 * 1.0 / 1 = 100
+        (0, globals_1.expect)(vper_1.VPER.computeVPERForMatch([box])).toBeCloseTo(100, 5);
+    });
+    (0, globals_1.it)('returns positive value for attack kills (weight 1.0)', () => {
+        const box = makeBox();
+        box.attack.kills = 5;
+        box.misc.pointsPlayed = 10;
+        // 100 * 5 / 10 = 50
+        (0, globals_1.expect)(vper_1.VPER.computeVPERForMatch([box])).toBeCloseTo(50, 5);
+    });
+    (0, globals_1.it)('returns positive value for serve aces (weight 1.0)', () => {
+        const box = makeBox();
+        box.serve.aces = 4;
+        box.misc.pointsPlayed = 10;
+        // 100 * 4 / 10 = 40
+        (0, globals_1.expect)(vper_1.VPER.computeVPERForMatch([box])).toBeCloseTo(40, 5);
+    });
+    (0, globals_1.it)('returns positive value for solo blocks (weight 1.0)', () => {
+        const box = makeBox();
+        box.block.solo = 3;
+        box.misc.pointsPlayed = 10;
+        // 100 * 3 / 10 = 30
+        (0, globals_1.expect)(vper_1.VPER.computeVPERForMatch([box])).toBeCloseTo(30, 5);
+    });
+    (0, globals_1.it)('returns positive value for block assists (weight 0.5)', () => {
+        const box = makeBox();
+        box.block.assists = 4;
+        box.misc.pointsPlayed = 10;
+        // 100 * (4 * 0.5) / 10 = 20
+        (0, globals_1.expect)(vper_1.VPER.computeVPERForMatch([box])).toBeCloseTo(20, 5);
+    });
+    (0, globals_1.it)('returns positive value for setting assists (weight 0.7)', () => {
+        const box = makeBox();
+        box.setting.assists = 10;
+        box.misc.pointsPlayed = 10;
+        // 100 * 7 / 10 = 70
+        (0, globals_1.expect)(vper_1.VPER.computeVPERForMatch([box])).toBeCloseTo(70, 5);
+    });
+    (0, globals_1.it)('penalises terminal errors at weight -1.0 each', () => {
+        const box = makeBox();
+        box.attack.errors = 3;
+        box.misc.pointsPlayed = 10;
+        // 100 * (-3) / 10 = -30
+        (0, globals_1.expect)(vper_1.VPER.computeVPERForMatch([box])).toBeCloseTo(-30, 5);
+    });
+    (0, globals_1.it)('penalises overpasses at weight -0.6 each', () => {
+        const box = makeBox();
+        box.reception.overpasses = 5;
+        box.misc.pointsPlayed = 10;
+        // 100 * (5 * -0.6) / 10 = -30
+        (0, globals_1.expect)(vper_1.VPER.computeVPERForMatch([box])).toBeCloseTo(-30, 5);
+    });
+    (0, globals_1.it)('combines all types of contributions across a single box score', () => {
+        const box = makeBox();
+        box.attack.kills = 10; // +10
+        box.serve.errors = 2; // -2
+        box.setting.assists = 5; // +3.5
+        box.misc.pointsPlayed = 20;
+        // rawSum = 10 - 2 + 3.5 = 11.5; 100 * 11.5 / 20 = 57.5
+        (0, globals_1.expect)(vper_1.VPER.computeVPERForMatch([box])).toBeCloseTo(57.5, 5);
+    });
+    (0, globals_1.it)('aggregates rawSum and pointsPlayed across multiple box scores', () => {
+        const box1 = makeBox();
+        box1.attack.kills = 10;
+        box1.misc.pointsPlayed = 20;
+        const box2 = makeBox();
+        box2.serve.errors = 2;
+        box2.misc.pointsPlayed = 10;
+        // rawSum = 10 - 2 = 8; pointsPlayedSum = 30; 100 * 8 / 30 ≈ 26.667
+        (0, globals_1.expect)(vper_1.VPER.computeVPERForMatch([box1, box2])).toBeCloseTo(26.667, 2);
+    });
+    (0, globals_1.it)('rewards defense digs (weight 0.25)', () => {
+        const box = makeBox();
+        box.defense.digs = 8;
+        box.misc.pointsPlayed = 10;
+        // 100 * (8 * 0.25) / 10 = 20
+        (0, globals_1.expect)(vper_1.VPER.computeVPERForMatch([box])).toBeCloseTo(20, 5);
+    });
+    (0, globals_1.it)('rewards perfect receptions (weight 0.35)', () => {
+        const box = makeBox();
+        box.reception.perfect = 4;
+        box.misc.pointsPlayed = 10;
+        // 100 * (4 * 0.35) / 10 = 14
+        (0, globals_1.expect)(vper_1.VPER.computeVPERForMatch([box])).toBeCloseTo(14, 5);
+    });
+});

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

@@ -0,0 +1,8 @@
+import { Rarity } from './rarity';
+import { Stats } from './stats';
+export type TrainingFocus = Stats;
+export declare function getStatCap(rarity: Rarity): number;
+export declare function getRarityMultiplier(rarity: Rarity): number;
+export declare function getImprovementThreshold(statTotal: number, rarity: Rarity): number;
+export declare function getCoachMultiplier(rarity: Rarity): number;
+export declare function selectImprovableStat(rarity: Rarity, trainingFocus: TrainingFocus, currentStats: Record<string, number>): string | null;

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

@@ -0,0 +1,82 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getStatCap = getStatCap;
+exports.getRarityMultiplier = getRarityMultiplier;
+exports.getImprovementThreshold = getImprovementThreshold;
+exports.getCoachMultiplier = getCoachMultiplier;
+exports.selectImprovableStat = selectImprovableStat;
+const stat_config_1 = require("../../stat-config");
+const rarity_1 = require("./rarity");
+const performance_stats_1 = require("./performance-stats");
+const stats_1 = require("./stats");
+const CURVE_BASE = 100;
+const CURVE_SCALAR = 0.098;
+const CURVE_EXPONENT = 1.5;
+const statCaps = stat_config_1.statCapsJSON;
+function getStatCap(rarity) {
+    const entry = statCaps.find(e => e.rarity === rarity);
+    if (entry == null)
+        throw new Error(`UNKNOWN_RARITY: ${rarity}`);
+    return entry.cap;
+}
+function getRarityMultiplier(rarity) {
+    const entry = statCaps.find(e => e.rarity === rarity);
+    if (entry == null)
+        throw new Error(`UNKNOWN_RARITY: ${rarity}`);
+    return entry.rarityMultiplier;
+}
+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 = {
+    [rarity_1.RarityEnum.COMMON]: 2.0,
+    [rarity_1.RarityEnum.RARE]: 1.5,
+    [rarity_1.RarityEnum.LEGENDARY]: 1.0,
+    [rarity_1.RarityEnum.MYTHIC]: 0.85,
+    [rarity_1.RarityEnum.SPECIAL]: 0.65
+};
+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'
+};
+function selectImprovableStat(rarity, trainingFocus, currentStats) {
+    const cap = getStatCap(rarity);
+    const multipliers = (0, stats_1.getMultipliers)(trainingFocus);
+    const focusPool = [];
+    const fallbackPool = [];
+    for (const key of performance_stats_1.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/cjs/src/service/player/improvement.test.d.ts

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

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

@@ -0,0 +1,144 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const globals_1 = require("@jest/globals");
+const rarity_1 = require("./rarity");
+const improvement_1 = require("./improvement");
+const stats_1 = require("./stats");
+// ─── getStatCap ───────────────────────────────────────────────────────────────
+(0, globals_1.describe)('getStatCap()', () => {
+    globals_1.it.each([
+        [rarity_1.RarityEnum.COMMON, 59],
+        [rarity_1.RarityEnum.RARE, 69],
+        [rarity_1.RarityEnum.LEGENDARY, 79],
+        [rarity_1.RarityEnum.MYTHIC, 89],
+        [rarity_1.RarityEnum.SPECIAL, 99]
+    ])('%s → cap %i', (rarity, expected) => {
+        (0, globals_1.expect)((0, improvement_1.getStatCap)(rarity)).toBe(expected);
+    });
+    (0, globals_1.it)('throws UNKNOWN_RARITY for an unrecognised rarity string', () => {
+        (0, globals_1.expect)(() => (0, improvement_1.getStatCap)('DIVINE')).toThrow('UNKNOWN_RARITY');
+    });
+});
+// ─── getRarityMultiplier ──────────────────────────────────────────────────────
+(0, globals_1.describe)('getRarityMultiplier()', () => {
+    globals_1.it.each([
+        [rarity_1.RarityEnum.COMMON, 1.0],
+        [rarity_1.RarityEnum.RARE, 1.15],
+        [rarity_1.RarityEnum.LEGENDARY, 1.3],
+        [rarity_1.RarityEnum.MYTHIC, 1.5],
+        [rarity_1.RarityEnum.SPECIAL, 1.75]
+    ])('%s → multiplier %f', (rarity, expected) => {
+        (0, globals_1.expect)((0, improvement_1.getRarityMultiplier)(rarity)).toBeCloseTo(expected, 5);
+    });
+    (0, globals_1.it)('throws UNKNOWN_RARITY for an unrecognised rarity string', () => {
+        (0, globals_1.expect)(() => (0, improvement_1.getRarityMultiplier)('DIVINE')).toThrow('UNKNOWN_RARITY');
+    });
+});
+// ─── getImprovementThreshold ──────────────────────────────────────────────────
+(0, globals_1.describe)('getImprovementThreshold()', () => {
+    (0, globals_1.it)('at statTotal=6 the curve exponent term is 0 → threshold = round(100 / rarityMultiplier)', () => {
+        // COMMON (multiplier 1.0): round(100 / 1.0) = 100
+        (0, globals_1.expect)((0, improvement_1.getImprovementThreshold)(6, rarity_1.RarityEnum.COMMON)).toBe(100);
+        // LEGENDARY (multiplier 1.3): round(100 / 1.3) = 77
+        (0, globals_1.expect)((0, improvement_1.getImprovementThreshold)(6, rarity_1.RarityEnum.LEGENDARY)).toBe(Math.round(100 / 1.3));
+    });
+    (0, globals_1.it)('threshold increases as statTotal grows beyond 6', () => {
+        const low = (0, improvement_1.getImprovementThreshold)(10, rarity_1.RarityEnum.COMMON);
+        const high = (0, improvement_1.getImprovementThreshold)(50, rarity_1.RarityEnum.COMMON);
+        (0, globals_1.expect)(high).toBeGreaterThan(low);
+    });
+    (0, globals_1.it)('higher rarity multiplier yields lower threshold (easier improvement)', () => {
+        const common = (0, improvement_1.getImprovementThreshold)(30, rarity_1.RarityEnum.COMMON);
+        const legendary = (0, improvement_1.getImprovementThreshold)(30, rarity_1.RarityEnum.LEGENDARY);
+        (0, globals_1.expect)(legendary).toBeLessThan(common);
+    });
+    (0, globals_1.it)('returns an integer (Math.round applied)', () => {
+        (0, globals_1.expect)(Number.isInteger((0, improvement_1.getImprovementThreshold)(20, rarity_1.RarityEnum.RARE))).toBe(true);
+    });
+});
+// ─── getCoachMultiplier ───────────────────────────────────────────────────────
+(0, globals_1.describe)('getCoachMultiplier()', () => {
+    globals_1.it.each([
+        [rarity_1.RarityEnum.COMMON, 2.0],
+        [rarity_1.RarityEnum.RARE, 1.5],
+        [rarity_1.RarityEnum.LEGENDARY, 1.0],
+        [rarity_1.RarityEnum.MYTHIC, 0.85],
+        [rarity_1.RarityEnum.SPECIAL, 0.65]
+    ])('%s → %f', (rarity, expected) => {
+        (0, globals_1.expect)((0, improvement_1.getCoachMultiplier)(rarity)).toBeCloseTo(expected, 10);
+    });
+    (0, globals_1.it)('higher rarity → lower coach multiplier (rarer players improve more slowly)', () => {
+        (0, globals_1.expect)((0, improvement_1.getCoachMultiplier)(rarity_1.RarityEnum.COMMON)).toBeGreaterThan((0, improvement_1.getCoachMultiplier)(rarity_1.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
+    };
+}
+(0, globals_1.describe)('selectImprovableStat()', () => {
+    (0, globals_1.it)('returns null when every stat is at or above the rarity cap', () => {
+        const cap = (0, improvement_1.getStatCap)(rarity_1.RarityEnum.COMMON); // 59
+        (0, globals_1.expect)((0, improvement_1.selectImprovableStat)(rarity_1.RarityEnum.COMMON, stats_1.StatsEnum.ATTACK, allStats(cap))).toBeNull();
+    });
+    (0, globals_1.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 = (0, improvement_1.selectImprovableStat)(rarity_1.RarityEnum.COMMON, stats_1.StatsEnum.SERVE, stats);
+            (0, globals_1.expect)(result).not.toBeNull();
+            (0, globals_1.expect)(focusPool.has(result)).toBe(true);
+        }
+    });
+    (0, globals_1.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 = (0, improvement_1.selectImprovableStat)(rarity_1.RarityEnum.COMMON, stats_1.StatsEnum.RECEIVE, stats);
+            (0, globals_1.expect)(result).not.toBeNull();
+            (0, globals_1.expect)(focusPool.has(result)).toBe(true);
+        }
+    });
+    (0, globals_1.it)('falls back to any improvable stat when all focus-pool stats are capped', () => {
+        const cap = (0, improvement_1.getStatCap)(rarity_1.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 = (0, improvement_1.selectImprovableStat)(rarity_1.RarityEnum.COMMON, stats_1.StatsEnum.SERVE, stats);
+            (0, globals_1.expect)(result).not.toBeNull();
+            // Must never return one of the capped focus stats
+            (0, globals_1.expect)(['serve', 'awareness', 'attack']).not.toContain(result);
+        }
+    });
+    (0, globals_1.it)('returns a string (DB column name) not a PerformanceStatsKey', () => {
+        const stats = allStats(1);
+        const result = (0, improvement_1.selectImprovableStat)(rarity_1.RarityEnum.COMMON, stats_1.StatsEnum.ATTACK, stats);
+        // back_attack is the DB column for backAttack — verify the column naming convention
+        if (result === 'back_attack') {
+            (0, globals_1.expect)(result).toBe('back_attack');
+        }
+        else {
+            (0, globals_1.expect)(typeof result).toBe('string');
+        }
+    });
+});

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

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

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

@@ -0,0 +1,24 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./player"), exports);
+__exportStar(require("./improvement"), exports);
+__exportStar(require("./player-generator"), exports);
+__exportStar(require("./performance-stats"), exports);
+__exportStar(require("./trait"), exports);
+__exportStar(require("./rarity"), exports);
+__exportStar(require("./role"), exports);
+__exportStar(require("./stats"), exports);

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

@@ -0,0 +1,5 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.performanceStatKeys = void 0;
+exports.performanceStatKeys = ['setting', 'serve', 'spike', 'quick', 'power', 'awareness', 'attack', 'backAttack',
+    'reception', 'overhand', 'bump', 'block', 'read', 'commit', 'focus', 'defense', 'stamina', 'reflex'];

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

@@ -0,0 +1,35 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PerformanceStats = exports.performanceStatKeys = void 0;
+const performance_stats_z_1 = require("./schemas/performance-stats.z");
+const performance_stats_keys_1 = require("./performance-stats-keys");
+Object.defineProperty(exports, "performanceStatKeys", { enumerable: true, get: function () { return performance_stats_keys_1.performanceStatKeys; } });
+class PerformanceStats {
+    static create(input) {
+        const result = performance_stats_z_1.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(performance_stats_keys_1.performanceStatKeys.map((key) => [key, avg]));
+        return PerformanceStats.create(opts);
+    }
+    toString() {
+        return performance_stats_keys_1.performanceStatKeys.map((key) => `${key}: ${this[key]}`)
+            .join(', ');
+    }
+}
+exports.PerformanceStats = PerformanceStats;

package/dist/cjs/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;