volleyballsimtypes 0.0.139 → 0.0.140

package/dist/esm/service/match/match.js

@@ -0,0 +1,57 @@
+import { validateUUID } from '../utils';
+import { MatchTeam } from './match-team';
+export var MatchScore;
+(function (MatchScore) {
+    MatchScore["3-0"] = "3-0";
+    MatchScore["3-1"] = "3-1";
+    MatchScore["3-2"] = "3-2";
+    MatchScore["2-3"] = "2-3";
+    MatchScore["1-3"] = "1-3";
+    MatchScore["0-3"] = "0-3";
+})(MatchScore || (MatchScore = {}));
+export class Match {
+    constructor({ id, homeTeam, awayTeam, scheduledDate, sets, isSimulated }) {
+        validateUUID(id);
+        this.id = id;
+        this.homeTeam = homeTeam;
+        this.awayTeam = awayTeam;
+        this.scheduledDate = scheduledDate;
+        this.sets = sets;
+        this.isSimulated = isSimulated;
+    }
+    addSet(set) {
+        if (this.sets.length >= Match.BEST_OF)
+            throw new Error('SET_AMOUNT_EXCEEDED');
+        this.sets.push(set);
+    }
+    getTeamSets(team) {
+        return this.sets.reduce((sets, set) => sets + (!set.isOver() ? 0 : set.getWinner() === team ? 1 : 0), 0);
+    }
+    getScore() {
+        return `${this.getTeamSets(MatchTeam.HOME)}-${this.getTeamSets(MatchTeam.AWAY)}`;
+    }
+    isOver() {
+        const gamesRequired = Math.ceil(Match.BEST_OF / 2);
+        const lastSet = this.sets.at(-1);
+        if (lastSet == null || !lastSet.isOver() || this.sets.length < gamesRequired)
+            return false;
+        const homeSets = this.getTeamSets(MatchTeam.HOME);
+        const awaySets = this.getTeamSets(MatchTeam.AWAY);
+        // Check if any of the teams has enough sets to win.
+        return !(homeSets < gamesRequired && awaySets < gamesRequired);
+    }
+    getWinner() {
+        if (!this.isOver())
+            throw new Error('UNFINISHED_MATCH');
+        const homeSets = this.getTeamSets(MatchTeam.HOME);
+        const awaySets = this.getTeamSets(MatchTeam.AWAY);
+        return homeSets > awaySets ? this.homeTeam : this.awayTeam;
+    }
+    isWinner(team) {
+        if (team === MatchTeam.HOME && this.getWinner() === this.homeTeam)
+            return true;
+        else
+            return team === MatchTeam.AWAY && this.getWinner() === this.awayTeam;
+    }
+}
+Match.BEST_OF = 5;

package/dist/esm/service/match/rally.d.ts

@@ -0,0 +1,22 @@
+import { Team } from '../team';
+import { CourtPosition } from './court-position';
+import { RallyEvent } from '../event';
+interface RallyParams {
+    readonly id: string;
+    readonly order: number;
+    readonly servingTeam: Team;
+    readonly events: RallyEvent[];
+}
+export interface PlayerPosition {
+    position: CourtPosition;
+    playerId: string;
+}
+export declare class Rally {
+    readonly id: string;
+    readonly servingTeam: Team;
+    readonly events: RallyEvent[];
+    readonly order: number;
+    constructor({ id, order, servingTeam, events }: RallyParams);
+    addEvent(event: RallyEvent): void;
+}
+export {};

package/dist/esm/service/match/rally.js

@@ -0,0 +1,13 @@
+import { validateUUID } from '../utils';
+export class Rally {
+    constructor({ id, order, servingTeam, events }) {
+        validateUUID(id);
+        this.id = id;
+        this.order = order;
+        this.servingTeam = servingTeam;
+        this.events = events;
+    }
+    addEvent(event) {
+        this.events.push(event);
+    }
+}

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

@@ -0,0 +1,5 @@
+export * from './player';
+export * from './performance-stats';
+export * from './role';
+export * from './trait';
+export * from './stats';

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

@@ -0,0 +1,5 @@
+export * from './player';
+export * from './performance-stats';
+export * from './role';
+export * from './trait';
+export * from './stats';

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

@@ -0,0 +1,30 @@
+interface PerformanceStatsParams {
+    readonly setting: number;
+    readonly pass: number;
+    readonly reception: number;
+    readonly spike: number;
+    readonly backAttack: number;
+    readonly jump: number;
+    readonly block: number;
+    readonly awareness: number;
+    readonly serve: number;
+    readonly defense: number;
+    readonly stamina: number;
+}
+export declare class PerformanceStats {
+    readonly setting: number;
+    readonly pass: number;
+    readonly reception: number;
+    readonly spike: number;
+    readonly backAttack: number;
+    readonly jump: number;
+    readonly block: number;
+    readonly awareness: number;
+    readonly serve: number;
+    readonly defense: number;
+    readonly stamina: number;
+    constructor(opts: PerformanceStatsParams);
+    toString(): string;
+    static fromAverage(average: number): PerformanceStats;
+}
+export {};

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

@@ -0,0 +1,34 @@
+import { getKeys } from '../utils';
+export class PerformanceStats {
+    constructor(opts) {
+        this.serve = opts.serve;
+        this.pass = opts.pass;
+        this.setting = opts.setting;
+        this.reception = opts.reception;
+        this.spike = opts.spike;
+        this.backAttack = opts.backAttack;
+        this.jump = opts.jump;
+        this.block = opts.block;
+        this.awareness = opts.awareness;
+        this.defense = opts.defense;
+        this.stamina = opts.stamina;
+    }
+    toString() {
+        return getKeys(this).map(key => `${key}: ${this[key]}`).join(', ');
+    }
+    static fromAverage(average) {
+        return new PerformanceStats({
+            setting: average,
+            pass: average,
+            reception: average,
+            spike: average,
+            backAttack: average,
+            jump: average,
+            block: average,
+            awareness: average,
+            serve: average,
+            defense: average,
+            stamina: average
+        });
+    }
+}

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

@@ -0,0 +1,46 @@
+import { PerformanceStats } from './performance-stats';
+import { Role } from './role';
+import { Trait } from './trait';
+import { Country } from '../country';
+import { GeneralStat } from './stats';
+export declare class Stat {
+    readonly name: GeneralStat;
+    readonly value: number;
+    constructor({ name, value }: {
+        name: GeneralStat;
+        value: number;
+    });
+    toString(): string;
+}
+interface PlayerParams {
+    readonly id: string;
+    readonly name: Name;
+    readonly country: Country;
+    readonly stats: PerformanceStats;
+    readonly roles: Role[];
+    readonly traits: Trait[];
+}
+export declare class Name {
+    readonly first: string;
+    readonly last: string;
+    constructor({ first, last }: {
+        first: string;
+        last: string;
+    });
+    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[];
+    constructor({ id, name, country, stats, roles, traits }: PlayerParams);
+    static sortPlayers(roles: Role[]): (p1: Player, p2: Player) => number;
+    static compareStats(p1: Player, p2: Player): number;
+    canPlayLibero(): boolean;
+    toString(): string;
+}
+export {};

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

@@ -0,0 +1,84 @@
+import { Role } from './role';
+import { validateUUID } from '../utils';
+import { GeneralStat } from './stats';
+export class Stat {
+    constructor({ name, value }) {
+        this.name = name;
+        this.value = value;
+    }
+    toString() {
+        return `${this.name}: ${this.value}`;
+    }
+}
+export class Name {
+    constructor({ first, last }) {
+        this.first = first;
+        this.last = last;
+    }
+    toString() {
+        return `${this.first} ${this.last}`;
+    }
+}
+export class Player {
+    constructor({ id, name, country, stats, roles, traits }) {
+        validateUUID(id);
+        this.id = id;
+        this.name = name;
+        this.country = country;
+        this.stats = stats;
+        this.roles = roles;
+        this.traits = traits;
+        this.generalStats = GeneralStat.getStats()
+            .map(stat => ({
+            name: stat,
+            value: GeneralStat.calculateScore(stats, stat)
+        }));
+    }
+    // Used as a base sorting function for players
+    static sortPlayers(roles) {
+        return (p1, p2) => roles.reduce((x, role) => {
+            const p2Score = Role.calculateScore(p2.stats, role);
+            const p1Score = Role.calculateScore(p1.stats, role);
+            return x + p2Score - p1Score;
+        }, 0);
+    }
+    static compareStats(p1, p2) {
+        const compareFn = (acc, current) => {
+            let x = current.value;
+            switch (current.name) {
+                case GeneralStat.ATTACK:
+                    x *= 0.35;
+                    break;
+                case GeneralStat.DEFENSE:
+                    x *= 0.35;
+                    break;
+                case GeneralStat.SERVE:
+                    x *= 0.2;
+                    break;
+                case GeneralStat.PHYSICAL:
+                    x *= 0.1;
+                    break;
+                default:
+                    x *= 0;
+            }
+            return acc + x;
+        };
+        const s1 = p1.generalStats.reduce(compareFn, 0);
+        const s2 = p2.generalStats.reduce(compareFn, 0);
+        return s2 - s1;
+    }
+    canPlayLibero() {
+        return this.roles.includes(Role.LIBERO);
+    }
+    toString() {
+        return JSON.stringify({
+            id: this.id,
+            name: this.name.toString(),
+            country: this.country.toString(),
+            stats: this.stats.toString(),
+            roles: `[${this.roles.map(r => r.toString()).join(',')}]`,
+            traits: `[${this.traits.map(r => r.toString()).join(',')}]`,
+            generalStats: `[${this.generalStats.map(r => r.toString()).join(',')}]`
+        });
+    }
+}

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

@@ -0,0 +1,17 @@
+import { PerformanceStats } from './performance-stats';
+import { RoleType } from '../../data';
+export declare class Role {
+    static readonly SETTER: Role;
+    static readonly LIBERO: Role;
+    static readonly OUTSIDE_HITTER: Role;
+    static readonly OPPOSITE_HITTER: Role;
+    static readonly MIDDLE_BLOCKER: Role;
+    static readonly DEFENSIVE_SPECIALIST: Role;
+    private static readonly ROLES;
+    readonly name: RoleType;
+    private constructor();
+    toString(): string;
+    static getRoles(): Role[];
+    static calculateScore(stats: PerformanceStats, role: Role): number;
+    static assignRoles(stats: PerformanceStats): Role[];
+}

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

@@ -0,0 +1,42 @@
+import roleWeights from '../../../data/role.formula.json';
+export class Role {
+    constructor(name) {
+        this.name = name;
+    }
+    toString() {
+        return this.name;
+    }
+    static getRoles() {
+        return [...Role.ROLES];
+    }
+    static calculateScore(stats, role) {
+        const weights = roleWeights.find(r => r.role === role.name);
+        if (weights == null)
+            throw new Error('COULD_NOT_FIND_ROLE_WEIGHT');
+        const score = Object.entries(weights.weight)
+            .reduce((score, [key, value]) => score + (stats[key] * weights.weight[key]), 0);
+        return Math.round(score);
+    }
+    static assignRoles(stats) {
+        const scores = this.getRoles().map(role => ({
+            role,
+            score: this.calculateScore(stats, role)
+        })).sort((x, y) => y.score - x.score);
+        const out = [scores[0].role];
+        if (scores[1].score >= 75) {
+            out.push(scores[1].role);
+        }
+        if (scores[2].score >= 85) {
+            out.push(scores[2].role);
+        }
+        return out;
+    }
+}
+Role.SETTER = new Role('SETTER');
+Role.LIBERO = new Role('LIBERO');
+Role.OUTSIDE_HITTER = new Role('OUTSIDE_HITTER');
+Role.OPPOSITE_HITTER = new Role('OPPOSITE_HITTER');
+Role.MIDDLE_BLOCKER = new Role('MIDDLE_BLOCKER');
+Role.DEFENSIVE_SPECIALIST = new Role('DEFENSIVE_SPECIALIST');
+Role.ROLES = [Role.LIBERO, Role.SETTER, Role.OPPOSITE_HITTER, Role.OUTSIDE_HITTER, Role.MIDDLE_BLOCKER,
+    Role.DEFENSIVE_SPECIALIST];

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

@@ -0,0 +1,11 @@
+import { PerformanceStats } from './performance-stats';
+export declare enum GeneralStat {
+    ATTACK = "ATTACK",
+    DEFENSE = "DEFENSE",
+    SERVE = "SERVE",
+    PHYSICAL = "PHYSICAL"
+}
+export declare namespace GeneralStat {
+    function getStats(): GeneralStat[];
+    function calculateScore(performanceStats: PerformanceStats, statName: GeneralStat): number;
+}

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

@@ -0,0 +1,25 @@
+import stats from '../../../data/stat.formula.json';
+export var GeneralStat;
+(function (GeneralStat) {
+    GeneralStat["ATTACK"] = "ATTACK";
+    GeneralStat["DEFENSE"] = "DEFENSE";
+    GeneralStat["SERVE"] = "SERVE";
+    GeneralStat["PHYSICAL"] = "PHYSICAL";
+})(GeneralStat || (GeneralStat = {}));
+// eslint-disable-next-line @typescript-eslint/no-namespace
+(function (GeneralStat) {
+    const STATS = [GeneralStat.ATTACK, GeneralStat.DEFENSE, GeneralStat.SERVE, GeneralStat.PHYSICAL];
+    function getStats() {
+        return [...STATS];
+    }
+    GeneralStat.getStats = getStats;
+    function calculateScore(performanceStats, statName) {
+        const weights = stats.find(s => s.statName === statName);
+        if (weights == null)
+            throw new Error('COULD_NOT_FIND_ROLE_WEIGHT');
+        const score = Object.entries(weights.weight)
+            .reduce((score, [key, value]) => score + (performanceStats[key] * value), 0);
+        return Math.round(score);
+    }
+    GeneralStat.calculateScore = calculateScore;
+})(GeneralStat || (GeneralStat = {}));

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

@@ -0,0 +1,21 @@
+import { GeneralStat } from './stats';
+import { PerformanceStats } from './performance-stats';
+export declare class Trait {
+    static readonly MASTER_MIND: Trait;
+    static readonly MOVING_WALL: Trait;
+    static readonly MARKSMAN: Trait;
+    static readonly METEOR_SERVE: Trait;
+    static readonly VIGOROUS: Trait;
+    static readonly GUARDIAN: Trait;
+    readonly id: string;
+    readonly name: string;
+    readonly modifier: number;
+    readonly chance: number;
+    readonly statThreshold: number;
+    readonly stat: GeneralStat;
+    readonly weight: number;
+    private constructor();
+    static getTraits(): Trait[];
+    static assignTraits(performanceStats: PerformanceStats): Trait[];
+    toString(): string;
+}

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

@@ -0,0 +1,108 @@
+import { GeneralStat } from './stats';
+export class Trait {
+    constructor({ id, name, modifier, chance, statThreshold, stat, weight }) {
+        this.id = id;
+        this.name = name;
+        this.modifier = modifier;
+        this.chance = chance;
+        this.statThreshold = statThreshold;
+        this.stat = stat;
+        this.weight = weight;
+    }
+    static getTraits() {
+        return [Trait.GUARDIAN, Trait.MARKSMAN, Trait.METEOR_SERVE, Trait.VIGOROUS, Trait.MOVING_WALL, Trait.MASTER_MIND];
+    }
+    static assignTraits(performanceStats) {
+        const qualifiedTraits = this.getTraits().filter(trait => {
+            return GeneralStat.calculateScore(performanceStats, trait.stat) >= trait.statThreshold;
+        });
+        const random = Math.random();
+        let traitCount;
+        switch (true) {
+            case random > 0.95:
+                traitCount = 3;
+                break;
+            case random > 0.85:
+                traitCount = 2;
+                break;
+            case random > 0.6:
+                traitCount = 1;
+                break;
+            default:
+                traitCount = 0;
+        }
+        return qualifiedTraits.sort((t1, t2) => t2.weight - t1.weight)
+            .slice(0, traitCount);
+    }
+    toString() {
+        return JSON.stringify({
+            name: this.name,
+            modifier: this.modifier,
+            statThreshold: this.statThreshold,
+            chance: this.chance,
+            stat: this.stat,
+            weight: this.weight
+        });
+    }
+}
+// A Setter gets a bonus to their score and the receiving attacker gets a bonus as well.
+// Stacks with attacker bonus
+Trait.MASTER_MIND = new Trait({
+    id: '0117a315-a743-43e3-9ec2-ad5cf700ef08',
+    name: 'Master Mind',
+    modifier: 1.1,
+    chance: 0.2,
+    statThreshold: 80,
+    stat: GeneralStat.ATTACK,
+    weight: 10
+});
+// Will always participate in blocking regardless of chance and adds
+Trait.MOVING_WALL = new Trait({
+    id: '304c53f6-5e7a-44d3-9625-f10d8109421a',
+    name: 'Moving Wall',
+    modifier: 1.1,
+    chance: 1,
+    statThreshold: 75,
+    stat: GeneralStat.DEFENSE,
+    weight: 5
+});
+// On attack, will always pick the worst receiver and adds a 10% to score
+Trait.MARKSMAN = new Trait({
+    id: 'ace3458e-69ab-487c-a9c0-d656f705d8dd',
+    name: 'Marksman',
+    modifier: 1.01,
+    chance: 0.3,
+    statThreshold: 75,
+    stat: GeneralStat.ATTACK,
+    weight: 5
+});
+// Increases the score of the serve by 25% when serve type is Jumping.
+Trait.METEOR_SERVE = new Trait({
+    id: 'c929a79d-5866-40d6-bbd6-b0b67a929c4c',
+    name: 'Meteor Serve',
+    modifier: 1.1,
+    chance: 0.1,
+    statThreshold: 75,
+    stat: GeneralStat.SERVE,
+    weight: 10
+});
+// Has a 50% chance of taking an action without decreasing energy.
+Trait.VIGOROUS = new Trait({
+    id: 'f9599b87-b3b2-49ce-8224-470f6fe6ed64',
+    name: 'Vigorous',
+    modifier: 1,
+    statThreshold: 60,
+    chance: 0.5,
+    stat: GeneralStat.PHYSICAL,
+    weight: 1
+});
+// Takes place of the receiver and increases reception score by 25%, guaranteeing success. Can only trigger in back-row.
+Trait.GUARDIAN = new Trait({
+    id: 'c3291953-9256-4559-b5a9-955ccb8f9a6f',
+    name: 'Guardian',
+    chance: 0.25,
+    statThreshold: 75,
+    modifier: 1.25,
+    stat: GeneralStat.DEFENSE,
+    weight: 10
+});

package/dist/esm/service/team/index.d.ts

@@ -0,0 +1 @@
+export * from './team';

package/dist/esm/service/team/index.js

@@ -0,0 +1 @@
+export * from './team';

package/dist/esm/service/team/team.d.ts

@@ -0,0 +1,31 @@
+import { Coach } from '../coach';
+import { Player } from '../player';
+import { Country } from '../country';
+import { League } from '../competition';
+interface TeamParams {
+    readonly id: string;
+    readonly rating: number;
+    readonly name: string;
+    readonly shortName: string;
+    readonly roster: Player[];
+    readonly country?: Country;
+    readonly league?: League;
+    readonly coach?: Coach;
+}
+export declare class Team {
+    readonly id: string;
+    readonly roster: Player[];
+    readonly name: string;
+    readonly shortName: string;
+    readonly coach?: Coach;
+    readonly league?: League;
+    readonly country?: Country;
+    private _rating;
+    constructor({ id, rating, name, shortName, country, roster, coach, league }: TeamParams);
+    get rating(): number;
+    set rating(value: number);
+    isPlayerInRoster(player: Player): boolean;
+    toString(): string;
+    updateRating(rankingPoints: number): void;
+}
+export {};

package/dist/esm/service/team/team.js

@@ -0,0 +1,32 @@
+import { validateUUID } from '../utils';
+export class Team {
+    constructor({ id, rating, name, shortName, country, roster, coach, league }) {
+        validateUUID(id);
+        this.id = id;
+        this._rating = rating;
+        this.roster = roster;
+        this.coach = coach;
+        this.name = name;
+        this.shortName = shortName;
+        this.country = country;
+        this.league = league;
+    }
+    get rating() {
+        return this._rating;
+    }
+    set rating(value) {
+        this._rating = value;
+    }
+    isPlayerInRoster(player) {
+        return this.roster.some(p => p.id === player.id);
+    }
+    toString() {
+        if (this.country == null) {
+            throw new Error('UNKNOWN_COUNTRY');
+        }
+        return `${this.name} [${this.shortName}] (${this.country?.name}) ELO=${this._rating}`;
+    }
+    updateRating(rankingPoints) {
+        this._rating += rankingPoints;
+    }
+}

package/dist/esm/service/utils/index.d.ts

@@ -0,0 +1,2 @@
+export * from './string-utils';
+export * from './object-utils';

package/dist/esm/service/utils/index.js

@@ -0,0 +1,2 @@
+export * from './string-utils';
+export * from './object-utils';

package/dist/esm/service/utils/object-utils.d.ts

@@ -0,0 +1 @@
+export declare const getKeys: <T extends object>(obj: T) => (keyof T)[];

package/dist/esm/service/utils/object-utils.js

@@ -0,0 +1 @@
+export const getKeys = Object.keys;

package/dist/esm/service/utils/string-utils.d.ts

@@ -0,0 +1,2 @@
+export declare function formatNumber(n: number): string;
+export declare function validateUUID(uuid: string): boolean;

package/dist/esm/service/utils/string-utils.js

@@ -0,0 +1,11 @@
+export function formatNumber(n) {
+    if (n < 0)
+        throw new Error('UNEXPECTED_NEGATIVE_NUMBER');
+    return n < 10 ? `0${n}` : `${n}`;
+}
+export function validateUUID(uuid) {
+    const regex = /^[0-9a-fA-F]{8}\b-[0-9a-fA-F]{4}\b-[0-9a-fA-F]{4}\b-[0-9a-fA-F]{4}\b-[0-9a-fA-F]{12}$/;
+    if (!regex.test(uuid))
+        throw new Error('INVALID_UUID');
+    return true;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "volleyballsimtypes",
-  "version": "0.0.139",
+  "version": "0.0.140",
   "description": "vbsim types",
   "main": "./dist/cjs/src/index.js",
   "module": "./dist/esm/src/index.js",