volleyballsimtypes 0.0.359 → 0.0.361

package/dist/esm/src/service/team/schemas/tactics.z.js

@@ -0,0 +1,49 @@
+import { z } from 'zod';
+import { Player } from '../../player';
+const playerInstanceSchema = z.custom((v) => v instanceof Player, {
+    message: 'INVALID_PLAYER_INSTANCE'
+});
+const LEFT_FRONT = 4;
+const MIDDLE_FRONT = 3;
+const RIGHT_FRONT = 2;
+const LEFT_BACK = 5;
+const MIDDLE_BACK = 6;
+const RIGHT_BACK = 1;
+const LIBERO_ZONE = 0;
+const lineupSchema = z.object({
+    [LEFT_FRONT]: playerInstanceSchema,
+    [MIDDLE_FRONT]: playerInstanceSchema,
+    [RIGHT_FRONT]: playerInstanceSchema,
+    [LEFT_BACK]: playerInstanceSchema,
+    [MIDDLE_BACK]: playerInstanceSchema,
+    [RIGHT_BACK]: playerInstanceSchema,
+    [LIBERO_ZONE]: playerInstanceSchema.optional(),
+    bench: z.array(playerInstanceSchema)
+}).superRefine((data, ctx) => {
+    const players = [
+        data[LEFT_FRONT],
+        data[MIDDLE_FRONT],
+        data[RIGHT_FRONT],
+        data[LEFT_BACK],
+        data[MIDDLE_BACK],
+        data[RIGHT_BACK],
+        ...(data[LIBERO_ZONE] != null ? [data[LIBERO_ZONE]] : []),
+        ...data.bench
+    ];
+    const ids = players.map(p => p.id);
+    const uniqueCount = new Set(ids).size;
+    if (uniqueCount !== ids.length) {
+        ctx.addIssue({
+            code: 'custom',
+            message: 'LINEUP_HAS_DUPLICATE_PLAYERS',
+            path: ['bench']
+        });
+    }
+});
+export const TacticsInputSchema = z.object({
+    lineup: lineupSchema,
+    substitutionTolerance: z.number().int().min(1).max(50),
+    liberoReplacements: z.array(playerInstanceSchema),
+    pinchServerSubs: z.custom((v) => v instanceof Map &&
+        Array.from(v.entries()).every(([k, val]) => k instanceof Player && val instanceof Player), { message: 'INVALID_PINCH_SERVER_SUBS' })
+});

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

@@ -0,0 +1,28 @@
+import { z } from 'zod';
+import { Player } from '../../player';
+import { Country } from '../../country';
+export declare const TeamInputSchema: z.ZodObject<{
+    id: z.ZodUUID;
+    rating: z.ZodNumber;
+    name: z.ZodString;
+    shortName: z.ZodString;
+    divisionId: z.ZodUUID;
+    roster: z.ZodArray<z.ZodCustom<Player, Player>>;
+    country: z.ZodCustom<Country, Country>;
+    tactics: z.ZodOptional<z.ZodObject<{
+        lineup: z.ZodObject<{
+            4: z.ZodCustom<Player, Player>;
+            3: z.ZodCustom<Player, Player>;
+            2: z.ZodCustom<Player, Player>;
+            5: z.ZodCustom<Player, Player>;
+            6: z.ZodCustom<Player, Player>;
+            1: z.ZodCustom<Player, Player>;
+            0: z.ZodOptional<z.ZodCustom<Player, Player>>;
+            bench: z.ZodArray<z.ZodCustom<Player, Player>>;
+        }, z.core.$strip>;
+        substitutionTolerance: z.ZodNumber;
+        liberoReplacements: z.ZodArray<z.ZodCustom<Player, Player>>;
+        pinchServerSubs: z.ZodCustom<Map<Player, Player>, Map<Player, Player>>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type TeamInput = z.infer<typeof TeamInputSchema>;

package/dist/esm/src/service/team/schemas/team.z.js

@@ -0,0 +1,29 @@
+import { z } from 'zod';
+import { Player } from '../../player';
+import { Country } from '../../country';
+import { TacticsInputSchema } from './tactics.z';
+const playerInstanceSchema = z.custom((v) => v instanceof Player, {
+    message: 'INVALID_PLAYER_INSTANCE'
+});
+const countrySchema = z.custom((v) => v instanceof Country, {
+    message: 'INVALID_COUNTRY_INSTANCE'
+});
+export const TeamInputSchema = z.object({
+    id: z.uuid(),
+    rating: z.number().finite(),
+    name: z.string().trim().min(1),
+    shortName: z.string().trim().min(1),
+    divisionId: z.uuid(),
+    roster: z.array(playerInstanceSchema),
+    country: countrySchema,
+    tactics: TacticsInputSchema.optional()
+}).superRefine((data, ctx) => {
+    const ids = data.roster.map(p => p.id);
+    if (new Set(ids).size !== ids.length) {
+        ctx.addIssue({
+            code: 'custom',
+            message: 'TEAM_ROSTER_HAS_DUPLICATE_PLAYERS',
+            path: ['roster']
+        });
+    }
+});

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

@@ -0,0 +1,27 @@
+import { CourtPosition } from '../match';
+import { Player } from '../player';
+export interface StartingLineup {
+    readonly [CourtPosition.LEFT_FRONT]: Player;
+    readonly [CourtPosition.MIDDLE_FRONT]: Player;
+    readonly [CourtPosition.RIGHT_FRONT]: Player;
+    readonly [CourtPosition.LEFT_BACK]: Player;
+    readonly [CourtPosition.MIDDLE_BACK]: Player;
+    readonly [CourtPosition.RIGHT_BACK]: Player;
+    readonly [CourtPosition.LIBERO_ZONE]?: Player;
+    readonly bench: Player[];
+}
+export interface TacticsOpts {
+    readonly lineup: StartingLineup;
+    readonly substitutionTolerance: number;
+    readonly liberoReplacements: Player[];
+    readonly pinchServerSubs: Map<Player, Player>;
+}
+export declare class Tactics {
+    readonly lineup: StartingLineup;
+    readonly substitutionTolerance: number;
+    readonly liberoReplacements: Player[];
+    readonly pinchServerSubs: Map<Player, Player>;
+    static create(input: unknown): Tactics;
+    private constructor();
+    findPlayerInLineup(id: string): CourtPosition | undefined;
+}

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

@@ -0,0 +1,40 @@
+import { CourtPosition } from '../match';
+import { TacticsInputSchema } from './schemas/tactics.z';
+export class Tactics {
+    static create(input) {
+        const result = TacticsInputSchema.safeParse(input);
+        if (!result.success) {
+            throw new Error(`INVALID_TACTICS: ${result.error.message}. RECEIVED=${(() => { try {
+                return JSON.stringify(input);
+            }
+            catch {
+                return String(input);
+            } })()}`);
+        }
+        return new Tactics(result.data);
+    }
+    constructor({ lineup, pinchServerSubs, liberoReplacements, substitutionTolerance = 1 }) {
+        this.lineup = lineup;
+        this.substitutionTolerance = substitutionTolerance;
+        this.pinchServerSubs = pinchServerSubs;
+        this.liberoReplacements = liberoReplacements;
+    }
+    findPlayerInLineup(id) {
+        if (this.lineup.bench.some(p => p.id === id))
+            return CourtPosition.NOT_IN_COURT;
+        if (this.lineup[CourtPosition.LEFT_FRONT].id === id)
+            return CourtPosition.LEFT_FRONT;
+        if (this.lineup[CourtPosition.MIDDLE_FRONT].id === id)
+            return CourtPosition.MIDDLE_FRONT;
+        if (this.lineup[CourtPosition.RIGHT_FRONT].id === id)
+            return CourtPosition.RIGHT_FRONT;
+        if (this.lineup[CourtPosition.LEFT_BACK].id === id)
+            return CourtPosition.LEFT_BACK;
+        if (this.lineup[CourtPosition.MIDDLE_BACK].id === id)
+            return CourtPosition.MIDDLE_BACK;
+        if (this.lineup[CourtPosition.RIGHT_BACK].id === id)
+            return CourtPosition.RIGHT_BACK;
+        if (this.lineup[CourtPosition.LIBERO_ZONE]?.id === id)
+            return CourtPosition.LIBERO_ZONE;
+    }
+}

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

@@ -0,0 +1,15 @@
+import { Player, RarityEnum, Role } from '../player';
+import { Team } from './team';
+import { Country } from '../country';
+import { Tactics } from './tactics';
+export declare class TeamGenerator {
+    static readonly TEAM_PER_DIVISION = 16;
+    static readonly RARITIES: RarityEnum[];
+    static readonly ROLES: Role[];
+    private static getFormation;
+    private static comparePlayers;
+    static createRoster(country: Country): Player[];
+    static createTeams(divisionId: string, country: Country): Team[];
+    static createTactics(roster: Player[]): Tactics;
+    private static createLineup;
+}

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

@@ -0,0 +1,97 @@
+import { v4 as uuidv4 } from 'uuid';
+import { calculateRoleScore, Player, PlayerGenerator, RarityEnum, RoleEnum } from '../player';
+import { generateGenericTeamNames, randomNumber } from '../utils';
+import { Team } from './team';
+import { Tactics } from './tactics';
+import { Formation } from './formation';
+import { CourtPosition } from '../match';
+import logger from '../../logger';
+const buildBlock = (rarity, count) => Array.from({ length: count }, () => rarity);
+// eslint-disable-next-line @typescript-eslint/no-extraneous-class
+export class TeamGenerator {
+    static getFormation() {
+        const n = Math.floor(Math.random() * 3);
+        switch (n) {
+            case 0:
+                return Formation['4-2'];
+            case 1:
+                return Formation['5-1'];
+            case 2:
+                return Formation['6-2'];
+            default:
+                throw new Error('INVALID NUMBER');
+        }
+    }
+    static comparePlayers(roles) {
+        return (p1, p2) => roles.reduce((x, role) => {
+            const p2Score = calculateRoleScore(p2.stats, role);
+            const p1Score = calculateRoleScore(p1.stats, role);
+            return x + p2Score - p1Score;
+        }, 0);
+    }
+    static createRoster(country) {
+        return TeamGenerator.RARITIES.map((rarity, i) => PlayerGenerator.generatePlayer(country, rarity, this.ROLES[i % TeamGenerator.ROLES.length]));
+    }
+    static createTeams(divisionId, country) {
+        const names = generateGenericTeamNames(country.locales, TeamGenerator.TEAM_PER_DIVISION);
+        logger.info(`Creating teams for division: ${divisionId}`);
+        return names.map((name) => {
+            logger.info(`Creating players for team: ${name}`);
+            const roster = TeamGenerator.createRoster(country);
+            const tactics = TeamGenerator.createTactics(roster);
+            const shortName = name.replace(/\s+/g, '')
+                .slice(0, 3)
+                .toUpperCase();
+            return Team.create({
+                id: uuidv4(),
+                divisionId,
+                name,
+                shortName,
+                roster,
+                country,
+                tactics,
+                rating: 100
+            });
+        });
+    }
+    static createTactics(roster) {
+        const lineup = TeamGenerator.createLineup(roster, TeamGenerator.getFormation());
+        return Tactics.create({
+            lineup,
+            liberoReplacements: [lineup[3], lineup[6]],
+            pinchServerSubs: new Map(),
+            substitutionTolerance: Math.round(randomNumber(1, 50))
+        });
+    }
+    static createLineup(players, formation) {
+        if (players.length < 6)
+            throw new Error('NOT_ENOUGH_PLAYERS_FOR_TEAM_1');
+        const out = {};
+        let courtPlayer;
+        const libero = players.filter((player) => player.roles.includes(RoleEnum.LIBERO))
+            .sort(TeamGenerator.comparePlayers([RoleEnum.LIBERO]))
+            .shift();
+        if (libero == null)
+            throw new Error('UNDEFINED_LIBERO');
+        const filtered = players.filter(player => player.id !== libero.id);
+        for (let i = 1; i < 7; i++) {
+            courtPlayer = filtered.sort(TeamGenerator.comparePlayers(formation.initialRotation[i]))
+                .shift();
+            if (courtPlayer == null)
+                throw new Error('NOT_ENOUGH_PLAYERS_FOR_TEAM_2');
+            out[i] = courtPlayer;
+        }
+        // Can only have 12 players in the team.
+        out.bench = filtered.sort(Player.compareStats)
+            .slice(0, 5);
+        out[CourtPosition.LIBERO_ZONE] = libero;
+        return out;
+    }
+}
+TeamGenerator.TEAM_PER_DIVISION = 16;
+TeamGenerator.RARITIES = [
+    ...buildBlock(RarityEnum.COMMON, 7),
+    ...buildBlock(RarityEnum.RARE, 5),
+    ...buildBlock(RarityEnum.LEGENDARY, 2)
+];
+TeamGenerator.ROLES = [RoleEnum.LIBERO, RoleEnum.MIDDLE_BLOCKER, RoleEnum.OPPOSITE_HITTER, RoleEnum.OUTSIDE_HITTER, RoleEnum.SETTER];

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

@@ -0,0 +1,20 @@
+import { Player } from '../player';
+import { Country } from '../country';
+import { Tactics } from './tactics';
+export declare class Team {
+    readonly id: string;
+    readonly roster: Player[];
+    readonly name: string;
+    readonly shortName: string;
+    readonly divisionId: string;
+    readonly tactics?: Tactics;
+    readonly country: Country;
+    private _rating;
+    static create(input: unknown): Team;
+    private constructor();
+    get rating(): number;
+    set rating(value: number);
+    isPlayerInRoster(player: Player): boolean;
+    toString(): string;
+    updateRating(rankingPoints: number): void;
+}

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

@@ -0,0 +1,47 @@
+import { Tactics } from './tactics';
+import { TeamInputSchema } from './schemas/team.z';
+export class Team {
+    static create(input) {
+        const result = TeamInputSchema.safeParse(input);
+        if (!result.success) {
+            throw new Error(`INVALID_TEAM: ${result.error.message}. RECEIVED=${(() => { try {
+                return JSON.stringify(input);
+            }
+            catch {
+                return String(input);
+            } })()}`);
+        }
+        return new Team({
+            ...result.data,
+            tactics: result.data.tactics != null ? Tactics.create(result.data.tactics) : undefined
+        });
+    }
+    constructor({ id, rating, name, shortName, divisionId, country, roster, tactics }) {
+        this.id = id;
+        this._rating = rating;
+        this.roster = roster;
+        this.tactics = tactics;
+        this.name = name;
+        this.shortName = shortName;
+        this.divisionId = divisionId;
+        this.country = country;
+    }
+    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/src/service/test-helpers.d.ts

@@ -0,0 +1,38 @@
+import { Country } from './country';
+import { Player } from './player';
+import { Team } from './team';
+import { Match } from './match';
+import { MatchSet } from './match/match-set';
+export declare function makeCountry(): Country;
+export declare function makePlayer(country: Country, statValue?: number): Player;
+export declare function makeTeam(opts?: {
+    rating?: number;
+}): Team;
+/** Creates a finished MatchSet with no rallies (schema allows empty rallies at non-zero score). */
+export declare function makeFinishedSet(homeScore: number, awayScore: number, order?: number): MatchSet;
+/**
+ * Creates a COMPLETE Match where the home team wins 3-0.
+ * Sets: 25-10, 25-12, 25-8.
+ */
+export declare function makeMatch30(homeTeam: Team, awayTeam: Team): Match;
+/**
+ * Creates a COMPLETE Match where the home team wins 3-1.
+ * Sets (home wins 3, away wins 1): 25-20, 20-25, 25-18, 25-15.
+ */
+export declare function makeMatch31(homeTeam: Team, awayTeam: Team): Match;
+/**
+ * Creates a PENDING Match (no sets, no score).
+ */
+export declare function makePendingMatch(homeTeam: Team, awayTeam: Team): Match;
+/**
+ * Computes all derived Standing fields from raw win/loss counts so that
+ * Standing.create() passes its superRefine validation.
+ */
+export declare function standingInput(teamId: string, opts?: {
+    won30?: number;
+    won31?: number;
+    won32?: number;
+    lost03?: number;
+    lost13?: number;
+    lost23?: number;
+}): object;

package/dist/esm/src/service/test-helpers.js

@@ -0,0 +1,156 @@
+/**
+ * Minimal object factories for unit tests.
+ * NOT exported from any barrel — import directly from this file.
+ */
+import { v4 as uuidv4 } from 'uuid';
+import { Country } from './country';
+import { Player } from './player';
+import { Team } from './team';
+import { Match } from './match';
+import { MatchSet } from './match/match-set';
+import { StatusEnum } from '../data/common';
+import { RarityEnum } from './player/rarity';
+import { RoleEnum } from './player/role';
+import { DeclineProfileEnum } from './player/decline';
+import { performanceStatKeys } from './player/performance-stats-keys';
+// ─── Country ─────────────────────────────────────────────────────────────────
+export function makeCountry() {
+    return Country.create({
+        id: uuidv4(),
+        name: 'Test Country',
+        alpha2: 'TC',
+        alpha3: 'TCN',
+        code: 'TCN',
+        iso31662: 'TC-TEST'
+    });
+}
+// ─── Player ───────────────────────────────────────────────────────────────────
+export function makePlayer(country, statValue = 50) {
+    const stats = Object.fromEntries(performanceStatKeys.map((k) => [k, statValue]));
+    return Player.create({
+        id: uuidv4(),
+        name: { first: 'Test', last: 'Player' },
+        country,
+        stats,
+        roles: [RoleEnum.OUTSIDE_HITTER],
+        traits: [],
+        rarity: RarityEnum.COMMON,
+        age: 20,
+        declineProfile: DeclineProfileEnum.STANDARD
+    });
+}
+// ─── Team ─────────────────────────────────────────────────────────────────────
+export function makeTeam(opts = {}) {
+    const country = makeCountry();
+    const player = makePlayer(country);
+    return Team.create({
+        id: uuidv4(),
+        rating: opts.rating ?? 100,
+        name: 'Test Team',
+        shortName: 'TST',
+        divisionId: uuidv4(),
+        roster: [player],
+        country
+    });
+}
+// ─── MatchSet ────────────────────────────────────────────────────────────────
+/** Creates a finished MatchSet with no rallies (schema allows empty rallies at non-zero score). */
+export function makeFinishedSet(homeScore, awayScore, order = 0) {
+    return MatchSet.create({
+        id: uuidv4(),
+        order,
+        isTieBreak: false,
+        homePlayerPosition: [],
+        awayPlayerPosition: [],
+        homeScore,
+        awayScore,
+        boxScores: [],
+        rallies: []
+    });
+}
+// ─── Match ───────────────────────────────────────────────────────────────────
+/**
+ * Creates a COMPLETE Match where the home team wins 3-0.
+ * Sets: 25-10, 25-12, 25-8.
+ */
+export function makeMatch30(homeTeam, awayTeam) {
+    const sets = [
+        makeFinishedSet(25, 10, 0),
+        makeFinishedSet(25, 12, 1),
+        makeFinishedSet(25, 8, 2)
+    ];
+    return Match.create({
+        id: uuidv4(),
+        homeTeam,
+        awayTeam,
+        scheduledDate: new Date(),
+        status: StatusEnum.COMPLETE,
+        homeScore: 3,
+        awayScore: 0,
+        sets,
+        winner: homeTeam
+    });
+}
+/**
+ * Creates a COMPLETE Match where the home team wins 3-1.
+ * Sets (home wins 3, away wins 1): 25-20, 20-25, 25-18, 25-15.
+ */
+export function makeMatch31(homeTeam, awayTeam) {
+    const sets = [
+        makeFinishedSet(25, 20, 0),
+        makeFinishedSet(20, 25, 1),
+        makeFinishedSet(25, 18, 2),
+        makeFinishedSet(25, 15, 3)
+    ];
+    return Match.create({
+        id: uuidv4(),
+        homeTeam,
+        awayTeam,
+        scheduledDate: new Date(),
+        status: StatusEnum.COMPLETE,
+        homeScore: 3,
+        awayScore: 1,
+        sets,
+        winner: homeTeam
+    });
+}
+/**
+ * Creates a PENDING Match (no sets, no score).
+ */
+export function makePendingMatch(homeTeam, awayTeam) {
+    return Match.create({
+        id: uuidv4(),
+        homeTeam,
+        awayTeam,
+        scheduledDate: new Date(),
+        status: StatusEnum.PENDING
+    });
+}
+// ─── Standing input ───────────────────────────────────────────────────────────
+/**
+ * Computes all derived Standing fields from raw win/loss counts so that
+ * Standing.create() passes its superRefine validation.
+ */
+export function standingInput(teamId, opts = {}) {
+    const w30 = opts.won30 ?? 0;
+    const w31 = opts.won31 ?? 0;
+    const w32 = opts.won32 ?? 0;
+    const l03 = opts.lost03 ?? 0;
+    const l13 = opts.lost13 ?? 0;
+    const l23 = opts.lost23 ?? 0;
+    return {
+        teamId,
+        won30: w30,
+        won31: w31,
+        won32: w32,
+        lost03: l03,
+        lost13: l13,
+        lost23: l23,
+        points: (w30 + w31) * 3 + w32 * 2 + l23,
+        setsWon: (w32 + w31 + w30) * 3 + l23 * 2 + l13,
+        setsLost: (l03 + l13 + l23) * 3 + w32 * 2 + w31,
+        matchesWon: w30 + w31 + w32,
+        matchesLost: l03 + l13 + l23,
+        totalMatches: w30 + w31 + w32 + l03 + l13 + l23
+    };
+}

package/dist/esm/src/service/utils/faker-generators.d.ts

@@ -0,0 +1,25 @@
+export declare function getFakerInstance(locales: string[]): FakerLike;
+interface FakerLike {
+    location: {
+        city: () => string;
+        state?: () => string;
+        county?: () => string;
+    };
+    person: {
+        firstName: () => string;
+        lastName: () => string;
+    };
+    word: {
+        adjective: () => string;
+        noun: () => string;
+    };
+    datatype: {
+        boolean: () => boolean;
+    };
+}
+export declare function generateGenericTeamNames(locales: string[], amount: number): string[];
+export declare function generatePlayerName(locales: string[], amount: number): Array<{
+    first: string;
+    last: string;
+}>;
+export {};

package/dist/esm/src/service/utils/faker-generators.js

@@ -0,0 +1,77 @@
+import { allFakers, faker as FakerModule } from '@faker-js/faker';
+function isFakerKey(k) {
+    return k in allFakers;
+}
+export function getFakerInstance(locales) {
+    for (const locale of locales) {
+        if (isFakerKey(locale)) {
+            return allFakers[locale];
+        }
+    }
+    for (const locale of locales) {
+        const l = locale.split('_')[0];
+        if (isFakerKey(l)) {
+            return allFakers[l];
+        }
+    }
+    return FakerModule;
+}
+function clean(s) {
+    return s.replace(/\s+/g, ' ').trim();
+}
+function capitalize(s) {
+    return s.charAt(0).toUpperCase() + s.slice(1);
+}
+function nonEmpty(s) {
+    return s != null && s.length > 0 ? s : undefined;
+}
+function generateTeamName(faker) {
+    if (faker.datatype.boolean()) {
+        const city = nonEmpty(faker.location.city()) ??
+            nonEmpty(faker.location.state?.()) ??
+            nonEmpty(faker.location.county?.()) ??
+            faker.word.noun();
+        const mascot = capitalize(faker.word.noun());
+        return clean(`${city} ${mascot}`);
+    }
+    else {
+        const adjective = capitalize(faker.word.adjective());
+        const noun = capitalize(faker.word.noun());
+        return clean(`${adjective} ${noun}`);
+    }
+}
+const MAX_LAST_NAME_LENGTH = 16;
+const MAX_TEAM_NAME_LENGTH = 22;
+export function generateGenericTeamNames(locales, amount) {
+    if (amount <= 0)
+        return [];
+    const faker = getFakerInstance(locales);
+    const results = new Set();
+    const maxAttempts = amount * 20;
+    let attempts = 0;
+    while (results.size < amount && attempts < maxAttempts) {
+        const name = generateTeamName(faker);
+        if (name.length <= MAX_TEAM_NAME_LENGTH) {
+            results.add(name);
+        }
+        attempts++;
+    }
+    // Safety net: if the locale consistently generates long names, crop and add
+    while (results.size < amount) {
+        results.add(generateTeamName(faker).slice(0, MAX_TEAM_NAME_LENGTH));
+    }
+    return Array.from(results);
+}
+export function generatePlayerName(locales, amount) {
+    if (amount <= 0)
+        return [];
+    const faker = getFakerInstance(locales);
+    return Array.from({ length: amount }, () => {
+        const first = clean(faker.person.firstName());
+        let last = clean(faker.person.lastName());
+        while (last.length > MAX_LAST_NAME_LENGTH) {
+            last = clean(faker.person.lastName());
+        }
+        return { first, last };
+    });
+}

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

@@ -0,0 +1,4 @@
+export * from './object-utils';
+export * from './number-utils';
+export * from './rng-utils';
+export * from './faker-generators';

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

@@ -0,0 +1,4 @@
+export * from './object-utils';
+export * from './number-utils';
+export * from './rng-utils';
+export * from './faker-generators';

package/dist/esm/src/service/utils/number-utils.d.ts

@@ -0,0 +1,4 @@
+export declare function randomNumber(min: number, max: number): number;
+export declare function nextPowerOf2(n: number): number;
+export declare function clamp(min: number, max: number, value: number): number;
+export declare function erf(x: number): number;