volleyballsimtypes 0.0.356 → 0.0.358

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

@@ -0,0 +1,104 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TeamGenerator = void 0;
+const uuid_1 = require("uuid");
+const player_1 = require("../player");
+const utils_1 = require("../utils");
+const team_1 = require("./team");
+const tactics_1 = require("./tactics");
+const formation_1 = require("./formation");
+const match_1 = require("../match");
+const logger_1 = __importDefault(require("../../logger"));
+const buildBlock = (rarity, count) => Array.from({ length: count }, () => rarity);
+// eslint-disable-next-line @typescript-eslint/no-extraneous-class
+class TeamGenerator {
+    static getFormation() {
+        const n = Math.floor(Math.random() * 3);
+        switch (n) {
+            case 0:
+                return formation_1.Formation['4-2'];
+            case 1:
+                return formation_1.Formation['5-1'];
+            case 2:
+                return formation_1.Formation['6-2'];
+            default:
+                throw new Error('INVALID NUMBER');
+        }
+    }
+    static comparePlayers(roles) {
+        return (p1, p2) => roles.reduce((x, role) => {
+            const p2Score = (0, player_1.calculateRoleScore)(p2.stats, role);
+            const p1Score = (0, player_1.calculateRoleScore)(p1.stats, role);
+            return x + p2Score - p1Score;
+        }, 0);
+    }
+    static createRoster(country) {
+        return TeamGenerator.RARITIES.map((rarity, i) => player_1.PlayerGenerator.generatePlayer(country, rarity, this.ROLES[i % TeamGenerator.ROLES.length]));
+    }
+    static createTeams(divisionId, country) {
+        const names = (0, utils_1.generateGenericTeamNames)(country.locales, TeamGenerator.TEAM_PER_DIVISION);
+        logger_1.default.info(`Creating teams for division: ${divisionId}`);
+        return names.map((name) => {
+            logger_1.default.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_1.Team.create({
+                id: (0, uuid_1.v4)(),
+                divisionId,
+                name,
+                shortName,
+                roster,
+                country,
+                tactics,
+                rating: 100
+            });
+        });
+    }
+    static createTactics(roster) {
+        const lineup = TeamGenerator.createLineup(roster, TeamGenerator.getFormation());
+        return tactics_1.Tactics.create({
+            lineup,
+            liberoReplacements: [lineup[3], lineup[6]],
+            pinchServerSubs: new Map(),
+            substitutionTolerance: Math.round((0, utils_1.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(player_1.RoleEnum.LIBERO))
+            .sort(TeamGenerator.comparePlayers([player_1.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_1.Player.compareStats)
+            .slice(0, 5);
+        out[match_1.CourtPosition.LIBERO_ZONE] = libero;
+        return out;
+    }
+}
+exports.TeamGenerator = TeamGenerator;
+TeamGenerator.TEAM_PER_DIVISION = 16;
+TeamGenerator.RARITIES = [
+    ...buildBlock(player_1.RarityEnum.COMMON, 7),
+    ...buildBlock(player_1.RarityEnum.RARE, 5),
+    ...buildBlock(player_1.RarityEnum.LEGENDARY, 2)
+];
+TeamGenerator.ROLES = [player_1.RoleEnum.LIBERO, player_1.RoleEnum.MIDDLE_BLOCKER, player_1.RoleEnum.OPPOSITE_HITTER, player_1.RoleEnum.OUTSIDE_HITTER, player_1.RoleEnum.SETTER];

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

@@ -0,0 +1,51 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Team = void 0;
+const tactics_1 = require("./tactics");
+const team_z_1 = require("./schemas/team.z");
+class Team {
+    static create(input) {
+        const result = team_z_1.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_1.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;
+    }
+}
+exports.Team = Team;

package/dist/cjs/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/cjs/src/service/test-helpers.js

@@ -0,0 +1,163 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.makeCountry = makeCountry;
+exports.makePlayer = makePlayer;
+exports.makeTeam = makeTeam;
+exports.makeFinishedSet = makeFinishedSet;
+exports.makeMatch30 = makeMatch30;
+exports.makeMatch31 = makeMatch31;
+exports.makePendingMatch = makePendingMatch;
+exports.standingInput = standingInput;
+/**
+ * Minimal object factories for unit tests.
+ * NOT exported from any barrel — import directly from this file.
+ */
+const uuid_1 = require("uuid");
+const country_1 = require("./country");
+const player_1 = require("./player");
+const team_1 = require("./team");
+const match_1 = require("./match");
+const match_set_1 = require("./match/match-set");
+const common_1 = require("../data/common");
+const rarity_1 = require("./player/rarity");
+const role_1 = require("./player/role");
+const performance_stats_keys_1 = require("./player/performance-stats-keys");
+// ─── Country ─────────────────────────────────────────────────────────────────
+function makeCountry() {
+    return country_1.Country.create({
+        id: (0, uuid_1.v4)(),
+        name: 'Test Country',
+        alpha2: 'TC',
+        alpha3: 'TCN',
+        code: 'TCN',
+        iso31662: 'TC-TEST'
+    });
+}
+// ─── Player ───────────────────────────────────────────────────────────────────
+function makePlayer(country, statValue = 50) {
+    const stats = Object.fromEntries(performance_stats_keys_1.performanceStatKeys.map((k) => [k, statValue]));
+    return player_1.Player.create({
+        id: (0, uuid_1.v4)(),
+        name: { first: 'Test', last: 'Player' },
+        country,
+        stats,
+        roles: [role_1.RoleEnum.OUTSIDE_HITTER],
+        traits: [],
+        rarity: rarity_1.RarityEnum.COMMON
+    });
+}
+// ─── Team ─────────────────────────────────────────────────────────────────────
+function makeTeam(opts = {}) {
+    const country = makeCountry();
+    const player = makePlayer(country);
+    return team_1.Team.create({
+        id: (0, uuid_1.v4)(),
+        rating: opts.rating ?? 100,
+        name: 'Test Team',
+        shortName: 'TST',
+        divisionId: (0, uuid_1.v4)(),
+        roster: [player],
+        country
+    });
+}
+// ─── MatchSet ────────────────────────────────────────────────────────────────
+/** Creates a finished MatchSet with no rallies (schema allows empty rallies at non-zero score). */
+function makeFinishedSet(homeScore, awayScore, order = 0) {
+    return match_set_1.MatchSet.create({
+        id: (0, uuid_1.v4)(),
+        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.
+ */
+function makeMatch30(homeTeam, awayTeam) {
+    const sets = [
+        makeFinishedSet(25, 10, 0),
+        makeFinishedSet(25, 12, 1),
+        makeFinishedSet(25, 8, 2)
+    ];
+    return match_1.Match.create({
+        id: (0, uuid_1.v4)(),
+        homeTeam,
+        awayTeam,
+        scheduledDate: new Date(),
+        status: common_1.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.
+ */
+function makeMatch31(homeTeam, awayTeam) {
+    const sets = [
+        makeFinishedSet(25, 20, 0),
+        makeFinishedSet(20, 25, 1),
+        makeFinishedSet(25, 18, 2),
+        makeFinishedSet(25, 15, 3)
+    ];
+    return match_1.Match.create({
+        id: (0, uuid_1.v4)(),
+        homeTeam,
+        awayTeam,
+        scheduledDate: new Date(),
+        status: common_1.StatusEnum.COMPLETE,
+        homeScore: 3,
+        awayScore: 1,
+        sets,
+        winner: homeTeam
+    });
+}
+/**
+ * Creates a PENDING Match (no sets, no score).
+ */
+function makePendingMatch(homeTeam, awayTeam) {
+    return match_1.Match.create({
+        id: (0, uuid_1.v4)(),
+        homeTeam,
+        awayTeam,
+        scheduledDate: new Date(),
+        status: common_1.StatusEnum.PENDING
+    });
+}
+// ─── Standing input ───────────────────────────────────────────────────────────
+/**
+ * Computes all derived Standing fields from raw win/loss counts so that
+ * Standing.create() passes its superRefine validation.
+ */
+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/cjs/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/cjs/src/service/utils/faker-generators.js

@@ -0,0 +1,82 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getFakerInstance = getFakerInstance;
+exports.generateGenericTeamNames = generateGenericTeamNames;
+exports.generatePlayerName = generatePlayerName;
+const faker_1 = require("@faker-js/faker");
+function isFakerKey(k) {
+    return k in faker_1.allFakers;
+}
+function getFakerInstance(locales) {
+    for (const locale of locales) {
+        if (isFakerKey(locale)) {
+            return faker_1.allFakers[locale];
+        }
+    }
+    for (const locale of locales) {
+        const l = locale.split('_')[0];
+        if (isFakerKey(l)) {
+            return faker_1.allFakers[l];
+        }
+    }
+    return faker_1.faker;
+}
+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;
+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);
+}
+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/cjs/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/cjs/src/service/utils/index.js

@@ -0,0 +1,20 @@
+"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("./object-utils"), exports);
+__exportStar(require("./number-utils"), exports);
+__exportStar(require("./rng-utils"), exports);
+__exportStar(require("./faker-generators"), exports);

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

package/dist/cjs/src/service/utils/number-utils.js

@@ -0,0 +1,30 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.randomNumber = randomNumber;
+exports.nextPowerOf2 = nextPowerOf2;
+exports.clamp = clamp;
+exports.erf = erf;
+function randomNumber(min, max) {
+    return Math.random() * (max - min) + min;
+}
+function nextPowerOf2(n) { return n <= 1 ? 1 : 2 ** Math.ceil(Math.log2(n)); }
+function clamp(min, max, value) {
+    return Math.max(min, Math.min(value, max));
+}
+// Approximation of the error function
+function erf(x) {
+    // constants
+    const a1 = 0.254829592;
+    const a2 = -0.284496736;
+    const a3 = 1.421413741;
+    const a4 = -1.453152027;
+    const a5 = 1.061405429;
+    const p = 0.3275911;
+    // Save the sign of x
+    const sign = x < 0 ? -1 : 1;
+    x = Math.abs(x);
+    // Abramowitz & Stegun 7.1.26
+    const t = 1.0 / (1.0 + p * x);
+    const y = 1.0 - ((((a5 * t + a4) * t + a3) * t + a2) * t + a1) * t * Math.exp(-x * x);
+    return sign * y;
+}

package/dist/cjs/src/service/utils/number-utils.test.d.ts

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

package/dist/cjs/src/service/utils/number-utils.test.js

@@ -0,0 +1,71 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const globals_1 = require("@jest/globals");
+const number_utils_1 = require("./number-utils");
+// ─── clamp ───────────────────────────────────────────────────────────────────
+(0, globals_1.describe)('clamp()', () => {
+    (0, globals_1.it)('returns value when within range', () => {
+        (0, globals_1.expect)((0, number_utils_1.clamp)(0, 10, 5)).toBe(5);
+    });
+    (0, globals_1.it)('clamps to min when value is below', () => {
+        (0, globals_1.expect)((0, number_utils_1.clamp)(0, 10, -5)).toBe(0);
+    });
+    (0, globals_1.it)('clamps to max when value is above', () => {
+        (0, globals_1.expect)((0, number_utils_1.clamp)(0, 10, 15)).toBe(10);
+    });
+    (0, globals_1.it)('returns min when value equals min', () => {
+        (0, globals_1.expect)((0, number_utils_1.clamp)(0, 10, 0)).toBe(0);
+    });
+    (0, globals_1.it)('returns max when value equals max', () => {
+        (0, globals_1.expect)((0, number_utils_1.clamp)(0, 10, 10)).toBe(10);
+    });
+    (0, globals_1.it)('works with floating-point bounds', () => {
+        (0, globals_1.expect)((0, number_utils_1.clamp)(0.5, 9.5, 3.7)).toBeCloseTo(3.7, 10);
+        (0, globals_1.expect)((0, number_utils_1.clamp)(0.5, 9.5, 0.1)).toBeCloseTo(0.5, 10);
+        (0, globals_1.expect)((0, number_utils_1.clamp)(0.5, 9.5, 99)).toBeCloseTo(9.5, 10);
+    });
+});
+// ─── nextPowerOf2 ─────────────────────────────────────────────────────────────
+(0, globals_1.describe)('nextPowerOf2()', () => {
+    (0, globals_1.it)('returns 1 for n = 0', () => {
+        (0, globals_1.expect)((0, number_utils_1.nextPowerOf2)(0)).toBe(1);
+    });
+    (0, globals_1.it)('returns 1 for n = 1', () => {
+        (0, globals_1.expect)((0, number_utils_1.nextPowerOf2)(1)).toBe(1);
+    });
+    (0, globals_1.it)('returns the same value for exact powers of 2', () => {
+        (0, globals_1.expect)((0, number_utils_1.nextPowerOf2)(2)).toBe(2);
+        (0, globals_1.expect)((0, number_utils_1.nextPowerOf2)(4)).toBe(4);
+        (0, globals_1.expect)((0, number_utils_1.nextPowerOf2)(8)).toBe(8);
+        (0, globals_1.expect)((0, number_utils_1.nextPowerOf2)(16)).toBe(16);
+        (0, globals_1.expect)((0, number_utils_1.nextPowerOf2)(32)).toBe(32);
+    });
+    (0, globals_1.it)('rounds up to the next power of 2 for non-powers', () => {
+        (0, globals_1.expect)((0, number_utils_1.nextPowerOf2)(3)).toBe(4);
+        (0, globals_1.expect)((0, number_utils_1.nextPowerOf2)(5)).toBe(8);
+        (0, globals_1.expect)((0, number_utils_1.nextPowerOf2)(9)).toBe(16);
+        (0, globals_1.expect)((0, number_utils_1.nextPowerOf2)(17)).toBe(32);
+    });
+});
+// ─── erf ─────────────────────────────────────────────────────────────────────
+(0, globals_1.describe)('erf()', () => {
+    (0, globals_1.it)('returns ~0 for erf(0)', () => {
+        (0, globals_1.expect)((0, number_utils_1.erf)(0)).toBeCloseTo(0, 5);
+    });
+    (0, globals_1.it)('is antisymmetric: erf(-x) === -erf(x)', () => {
+        (0, globals_1.expect)((0, number_utils_1.erf)(-1)).toBeCloseTo(-(0, number_utils_1.erf)(1), 10);
+        (0, globals_1.expect)((0, number_utils_1.erf)(-0.5)).toBeCloseTo(-(0, number_utils_1.erf)(0.5), 10);
+    });
+    (0, globals_1.it)('approximates erf(1) ≈ 0.8427', () => {
+        (0, globals_1.expect)((0, number_utils_1.erf)(1)).toBeCloseTo(0.8427, 3);
+    });
+    (0, globals_1.it)('approximates erf(0.5) ≈ 0.5205', () => {
+        (0, globals_1.expect)((0, number_utils_1.erf)(0.5)).toBeCloseTo(0.5205, 3);
+    });
+    (0, globals_1.it)('approaches 1 for large positive input', () => {
+        (0, globals_1.expect)((0, number_utils_1.erf)(4)).toBeCloseTo(1, 4);
+    });
+    (0, globals_1.it)('approaches -1 for large negative input', () => {
+        (0, globals_1.expect)((0, number_utils_1.erf)(-4)).toBeCloseTo(-1, 4);
+    });
+});

package/dist/cjs/src/service/utils/object-utils.d.ts

@@ -0,0 +1,4 @@
+export declare const getKeys: <T extends object>(obj: T) => Array<keyof T>;
+export type DataProps<T> = {
+    [K in keyof T as T[K] extends (...args: any[]) => any ? never : K]: T[K];
+};

package/dist/cjs/src/service/utils/object-utils.js

@@ -0,0 +1,4 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getKeys = void 0;
+exports.getKeys = Object.keys;

package/dist/cjs/src/service/utils/rng-utils.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Fisher-Yates shuffle algorithm
+ * Shuffles array IN-PLACE
+ * @param {any[]} array
+ */
+export declare function shuffle<Type>(array: Type[]): Type[];
+export declare function calculateProbability(score: number, scale: number, minP: number, maxP: number): number;
+export declare function createUniqueRandomPicker(min: number, max: number, rng?: () => number): {
+    next: () => number;
+    reset: () => void;
+};