volleyballsimtypes 0.0.358 → 0.0.360

package/dist/cjs/src/data/models/player.d.ts

@@ -1,7 +1,7 @@
 import * as Sequelize from 'sequelize';
 import { Model } from 'sequelize';
 import { BoxScoreAttributes, BoxScoreId, BoxScoreModel, BoxScoreTotalsId, BoxScoreTotalsModel, CompetitionMVPId, CompetitionMVPModel, CountryId, CountryModel, MatchSetId, MatchSetModel, PerformanceStatsAttributes, PerformanceStatsId, PerformanceStatsModel, PlayerTeamId, PlayerTeamModel, TeamId, TeamModel, VPERId, VPERModel } from '.';
-import { Rarity, Role, Trait } from '../../service';
+import { DeclineProfile, Rarity, Role, Trait } from '../../service';
 export interface PlayerAttributes {
     player_id: string;
     roles: Role[];
@@ -10,6 +10,8 @@ export interface PlayerAttributes {
     first_name: string;
     last_name: string;
     country_id: string;
+    age: number;
+    decline_profile: DeclineProfile;
     PerformanceStat?: PerformanceStatsAttributes;
     BoxScores?: BoxScoreAttributes[];
 }
@@ -24,6 +26,8 @@ export declare class PlayerModel extends Model<PlayerAttributes, PlayerCreationA
     first_name: string;
     last_name: string;
     country_id: string;
+    age: number;
+    decline_profile: DeclineProfile;
     country: CountryModel;
     getCountry: Sequelize.BelongsToGetAssociationMixin<CountryModel>;
     setCountry: Sequelize.BelongsToSetAssociationMixin<CountryModel, CountryId>;

package/dist/cjs/src/data/models/player.js

@@ -39,6 +39,16 @@ class PlayerModel extends sequelize_1.Model {
                     model: 'Country',
                     key: 'country_id'
                 }
+            },
+            age: {
+                type: sequelize_1.DataTypes.INTEGER,
+                allowNull: false,
+                defaultValue: 17
+            },
+            decline_profile: {
+                type: sequelize_1.DataTypes.ENUM(...Object.values(service_1.DeclineProfileEnum)),
+                allowNull: false,
+                defaultValue: service_1.DeclineProfileEnum.STANDARD
             }
         }, {
             sequelize,

package/dist/cjs/src/data/transformers/player.js

@@ -20,7 +20,9 @@ function transformToAttributes(player) {
         roles: player.roles,
         traits: player.traits,
         PerformanceStat: (0, _1.transformFromPerformanceStats)(player.stats, player.id),
-        rarity: player.rarity
+        rarity: player.rarity,
+        age: player.age,
+        decline_profile: player.declineProfile
     };
 }
 function transformToBoxScoreTotals(model) {
@@ -79,6 +81,8 @@ function transformToObject(model) {
         traits: model.traits,
         stats: (0, _1.transformToPerformanceStats)(model.PerformanceStat),
         rarity: model.rarity,
+        age: model.age,
+        declineProfile: model.decline_profile,
         boxScores: (model.BoxScores ?? []).map(_1.transformToBoxScore),
         boxScoreTotals
     });

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

@@ -0,0 +1,43 @@
+import { PerformanceStatsKey } from './performance-stats-keys';
+export declare enum DeclineProfileEnum {
+    PRODIGY = "PRODIGY",
+    STANDARD = "STANDARD",
+    VETERAN = "VETERAN",
+    IRONMAN = "IRONMAN"
+}
+export type DeclineProfile = DeclineProfileEnum.PRODIGY | DeclineProfileEnum.STANDARD | DeclineProfileEnum.VETERAN | DeclineProfileEnum.IRONMAN;
+export declare const declineProfiles: DeclineProfileEnum[];
+interface DeclineProfileEntry {
+    profile: string;
+    startAge: number;
+    initTicks: number;
+    accel: number;
+    peakTicks: number;
+}
+/**
+ * Stats that decline first (technique / skill). One random stat from this pool is
+ * removed per tick during the pre-peak decline phase.
+ */
+export declare const SKILL_POOL: PerformanceStatsKey[];
+/**
+ * Energy / reaction stats (incl. crit-chance stats). These only start declining
+ * once the player reaches peak decline, alongside the skill pool.
+ */
+export declare const ENERGY_POOL: PerformanceStatsKey[];
+export declare function getDeclineProfile(profile: DeclineProfile): DeclineProfileEntry;
+export type DeclineStatus = 'ACTIVE' | 'DECLINING' | 'PEAK';
+export interface DeclineTick {
+    /** Number of decline ticks to apply this iteration. */
+    ticks: number;
+    /** True once tick rate hits the profile ceiling — both pools decline and training is blocked. */
+    atPeak: boolean;
+    /** Coarse status for display / gating. */
+    status: DeclineStatus;
+}
+/**
+ * Decline is fully derivable from age + profile — no running state is persisted.
+ *   tickRate = min(peakTicks, initTicks + (age - startAge) * accel)
+ * Pre-peak: `ticks` random SKILL stats lost. At peak: `ticks` from BOTH pools + training blocked.
+ */
+export declare function computeDeclineTick(age: number, profile: DeclineProfile): DeclineTick;
+export {};

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

@@ -0,0 +1,55 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ENERGY_POOL = exports.SKILL_POOL = exports.declineProfiles = exports.DeclineProfileEnum = void 0;
+exports.getDeclineProfile = getDeclineProfile;
+exports.computeDeclineTick = computeDeclineTick;
+const stat_config_1 = require("../../stat-config");
+var DeclineProfileEnum;
+(function (DeclineProfileEnum) {
+    DeclineProfileEnum["PRODIGY"] = "PRODIGY";
+    DeclineProfileEnum["STANDARD"] = "STANDARD";
+    DeclineProfileEnum["VETERAN"] = "VETERAN";
+    DeclineProfileEnum["IRONMAN"] = "IRONMAN";
+})(DeclineProfileEnum || (exports.DeclineProfileEnum = DeclineProfileEnum = {}));
+exports.declineProfiles = Object.values(DeclineProfileEnum);
+const profileEntries = stat_config_1.declineProfilesJSON;
+/**
+ * Stats that decline first (technique / skill). One random stat from this pool is
+ * removed per tick during the pre-peak decline phase.
+ */
+exports.SKILL_POOL = [
+    'setting', 'serve', 'spike', 'quick', 'power', 'backAttack',
+    'reception', 'overhand', 'bump', 'block', 'attack', 'defense'
+];
+/**
+ * Energy / reaction stats (incl. crit-chance stats). These only start declining
+ * once the player reaches peak decline, alongside the skill pool.
+ */
+exports.ENERGY_POOL = [
+    'stamina', 'reflex', 'read', 'commit', 'awareness', 'focus'
+];
+function getDeclineProfile(profile) {
+    const entry = profileEntries.find(e => e.profile === profile);
+    if (entry == null)
+        throw new Error(`UNKNOWN_DECLINE_PROFILE: ${profile}`);
+    return entry;
+}
+/**
+ * Decline is fully derivable from age + profile — no running state is persisted.
+ *   tickRate = min(peakTicks, initTicks + (age - startAge) * accel)
+ * Pre-peak: `ticks` random SKILL stats lost. At peak: `ticks` from BOTH pools + training blocked.
+ */
+function computeDeclineTick(age, profile) {
+    const { startAge, initTicks, accel, peakTicks } = getDeclineProfile(profile);
+    if (age < startAge) {
+        return { ticks: 0, atPeak: false, status: 'ACTIVE' };
+    }
+    const rawRate = initTicks + (age - startAge) * accel;
+    const tickRate = Math.min(peakTicks, rawRate);
+    const atPeak = rawRate >= peakTicks;
+    return {
+        ticks: Math.round(tickRate),
+        atPeak,
+        status: atPeak ? 'PEAK' : 'DECLINING'
+    };
+}

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

@@ -1,5 +1,6 @@
 export * from './player';
 export * from './improvement';
+export * from './decline';
 export * from './player-generator';
 export * from './performance-stats';
 export * from './trait';

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

@@ -16,6 +16,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./player"), exports);
 __exportStar(require("./improvement"), exports);
+__exportStar(require("./decline"), exports);
 __exportStar(require("./player-generator"), exports);
 __exportStar(require("./performance-stats"), exports);
 __exportStar(require("./trait"), exports);

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

@@ -13,6 +13,7 @@ const stat_config_1 = require("../../stat-config");
 const utils_1 = require("../utils");
 const player_1 = require("./player");
 const trait_1 = require("./trait");
+const decline_1 = require("./decline");
 const LEGENDARY_PITY_STEP = 0.004;
 const MYTHIC_PITY_STEP = 0.00001;
 const SPECIAL_PITY_STEP = 0.000005;
@@ -115,12 +116,12 @@ class PlayerGenerator {
         const BLOCK = (0, stats_1.getMultipliers)(stats_1.StatsEnum.BLOCK);
         const SERVE = (0, stats_1.getMultipliers)(stats_1.StatsEnum.SERVE);
         const STAMINA = (0, stats_1.getMultipliers)(stats_1.StatsEnum.STAMINA);
-        function buildPerformanceFromRole(weights, maxValue) {
+        function buildPerformanceFromRole(weights, minValue, maxValue) {
             return performance_stats_1.PerformanceStats.create(Object.fromEntries(performance_stats_1.performanceStatKeys.map((key) => {
                 if (weights[key] > 0)
-                    return [key, maxValue];
+                    return [key, (0, node_crypto_1.randomInt)(minValue, maxValue + 1)];
                 else
-                    return [key, Math.round((0, node_crypto_1.randomInt)(rarity_1.RarityRanges.COMMON[0], maxValue - 5))];
+                    return [key, (0, node_crypto_1.randomInt)(rarity_1.RarityRanges.COMMON[0], Math.max(minValue - 1, rarity_1.RarityRanges.COMMON[0] + 1))];
             })));
         }
         switch (rarity) {
@@ -128,7 +129,7 @@ class PlayerGenerator {
                 if (role != null) {
                     const weights = stat_config_1.rolesJSON.find(entry => entry.role === role)?.weight;
                     if (weights != null) {
-                        return buildPerformanceFromRole(weights, rarity_1.RarityRanges.COMMON[1]);
+                        return buildPerformanceFromRole(weights, rarity_1.RarityRanges.COMMON[0], rarity_1.RarityRanges.COMMON[1]);
                     }
                 }
                 return performance_stats_1.PerformanceStats.create(Object.fromEntries(performance_stats_1.performanceStatKeys.map((key) => [key, Math.round((0, node_crypto_1.randomInt)(rarity_1.RarityRanges.COMMON[0], rarity_1.RarityRanges.COMMON[1]))])));
@@ -137,7 +138,7 @@ class PlayerGenerator {
                 if (role != null) {
                     const weights = stat_config_1.rolesJSON.find(entry => entry.role === role)?.weight;
                     if (weights != null) {
-                        return buildPerformanceFromRole(weights, rarity_1.RarityRanges.RARE[1]);
+                        return buildPerformanceFromRole(weights, rarity_1.RarityRanges.RARE[0], rarity_1.RarityRanges.RARE[1]);
                     }
                 }
                 const stats = (0, utils_1.shuffle)([ATTACK, SET, SERVE, RECEIVE, BLOCK]);
@@ -155,7 +156,7 @@ class PlayerGenerator {
                 if (role != null) {
                     const weights = stat_config_1.rolesJSON.find(entry => entry.role === role)?.weight;
                     if (weights != null) {
-                        return buildPerformanceFromRole(weights, rarity_1.RarityRanges.LEGENDARY[1]);
+                        return buildPerformanceFromRole(weights, rarity_1.RarityRanges.LEGENDARY[0], rarity_1.RarityRanges.LEGENDARY[1]);
                     }
                 }
                 const s1 = (0, utils_1.shuffle)([ATTACK, SET, RECEIVE, BLOCK]);
@@ -174,7 +175,7 @@ class PlayerGenerator {
                 if (role != null) {
                     const weights = stat_config_1.rolesJSON.find(entry => entry.role === role)?.weight;
                     if (weights != null) {
-                        return buildPerformanceFromRole(weights, rarity_1.RarityRanges.MYTHIC[1]);
+                        return buildPerformanceFromRole(weights, rarity_1.RarityRanges.MYTHIC[0], rarity_1.RarityRanges.MYTHIC[1]);
                     }
                 }
                 const stats = (0, utils_1.shuffle)([ATTACK, SET, RECEIVE, BLOCK]);
@@ -192,7 +193,7 @@ class PlayerGenerator {
                 if (role != null) {
                     const weights = stat_config_1.rolesJSON.find(entry => entry.role === role)?.weight;
                     if (weights != null) {
-                        return buildPerformanceFromRole(weights, rarity_1.RarityRanges.SPECIAL[1]);
+                        return buildPerformanceFromRole(weights, rarity_1.RarityRanges.SPECIAL[0], rarity_1.RarityRanges.SPECIAL[1]);
                     }
                 }
                 const stats = (0, utils_1.shuffle)([ATTACK, SERVE, SET, RECEIVE, BLOCK]);
@@ -218,7 +219,9 @@ class PlayerGenerator {
         const stats = PlayerGenerator.generatePerformance(rarity, role);
         const roles = (0, role_1.assignRoles)(stats, rarity);
         const traits = (0, trait_1.assignTraits)(roles, rarity, maxTraits);
-        return player_1.Player.create({ id: (0, uuid_1.v4)(), name, country, stats, roles, traits, rarity });
+        const age = (0, node_crypto_1.randomInt)(15, 21);
+        const declineProfile = decline_1.declineProfiles[(0, node_crypto_1.randomInt)(0, decline_1.declineProfiles.length)];
+        return player_1.Player.create({ id: (0, uuid_1.v4)(), name, country, stats, roles, traits, rarity, age, declineProfile });
     }
     static generatePlayers(count, countries) {
         const players = [];

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

@@ -5,6 +5,7 @@ import { Rarity } from './rarity';
 import { Stats } from './stats';
 import { Role } from './role';
 import { BoxScore, BoxScoreTotals } from '../match';
+import { DeclineProfile } from './decline';
 export declare class Stat {
     readonly name: Stats;
     readonly value: number;
@@ -30,6 +31,8 @@ export declare class Player {
     readonly traits: Trait[];
     readonly generalStats: Stat[];
     readonly rarity: Rarity;
+    readonly age: number;
+    readonly declineProfile: DeclineProfile;
     readonly boxScores?: BoxScore[];
     readonly boxScoreTotals?: BoxScoreTotals;
     static create(input: unknown): Player;

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

@@ -54,7 +54,7 @@ class Player {
             stats: performance_stats_1.PerformanceStats.create(result.data.stats)
         });
     }
-    constructor({ id, name, country, stats, roles, traits, rarity, boxScores, boxScoreTotals }) {
+    constructor({ id, name, country, stats, roles, traits, rarity, age, declineProfile, boxScores, boxScoreTotals }) {
         this.id = id;
         this.name = name;
         this.country = country;
@@ -62,6 +62,8 @@ class Player {
         this.roles = roles;
         this.traits = traits;
         this.rarity = rarity;
+        this.age = age;
+        this.declineProfile = declineProfile;
         this.boxScores = boxScores;
         this.boxScoreTotals = boxScoreTotals;
         this.generalStats = Object.values(stats_1.StatsEnum).map((stat) => ({

package/dist/cjs/src/service/player/schemas/player.z.d.ts

@@ -3,6 +3,7 @@ import { Country } from '../../country';
 import { RoleEnum } from '../role';
 import { TraitEnum } from '../trait';
 import { RarityEnum } from '../rarity';
+import { DeclineProfileEnum } from '../decline';
 export declare const NameInputSchema: z.ZodObject<{
     first: z.ZodString;
     last: z.ZodString;
@@ -59,6 +60,13 @@ export declare const PlayerInputSchema: z.ZodObject<{
         MYTHIC: RarityEnum.MYTHIC;
         SPECIAL: RarityEnum.SPECIAL;
     }>;
+    age: z.ZodNumber;
+    declineProfile: z.ZodEnum<{
+        PRODIGY: DeclineProfileEnum.PRODIGY;
+        STANDARD: DeclineProfileEnum.STANDARD;
+        VETERAN: DeclineProfileEnum.VETERAN;
+        IRONMAN: DeclineProfileEnum.IRONMAN;
+    }>;
     boxScores: z.ZodOptional<z.ZodArray<z.ZodObject<{
         playerId: z.ZodUUID;
         matchSetId: z.ZodUUID;

package/dist/cjs/src/service/player/schemas/player.z.js

@@ -6,6 +6,7 @@ const country_1 = require("../../country");
 const role_1 = require("../role");
 const trait_1 = require("../trait");
 const rarity_1 = require("../rarity");
+const decline_1 = require("../decline");
 const box_score_z_1 = require("../../match/schemas/box-score.z");
 const performance_stats_z_1 = require("./performance-stats.z");
 exports.NameInputSchema = zod_1.z.object({
@@ -32,6 +33,8 @@ exports.PlayerInputSchema = zod_1.z.object({
     roles: zod_1.z.array(zod_1.z.enum(Object.values(role_1.RoleEnum))).min(1),
     traits: zod_1.z.array(zod_1.z.enum(Object.values(trait_1.TraitEnum))),
     rarity: zod_1.z.enum(Object.values(rarity_1.RarityEnum)),
+    age: zod_1.z.number().int().min(0),
+    declineProfile: zod_1.z.enum(Object.values(decline_1.DeclineProfileEnum)),
     boxScores: zod_1.z.array(box_score_z_1.BoxScoreInputSchema).optional(),
     boxScoreTotals: BoxScoreTotalsInputSchema.optional()
 });

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

@@ -21,6 +21,7 @@ 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 decline_1 = require("./player/decline");
 const performance_stats_keys_1 = require("./player/performance-stats-keys");
 // ─── Country ─────────────────────────────────────────────────────────────────
 function makeCountry() {
@@ -43,7 +44,9 @@ function makePlayer(country, statValue = 50) {
         stats,
         roles: [role_1.RoleEnum.OUTSIDE_HITTER],
         traits: [],
-        rarity: rarity_1.RarityEnum.COMMON
+        rarity: rarity_1.RarityEnum.COMMON,
+        age: 20,
+        declineProfile: decline_1.DeclineProfileEnum.STANDARD
     });
 }
 // ─── Team ─────────────────────────────────────────────────────────────────────

package/dist/cjs/src/stat-config/decline-profiles.json

@@ -0,0 +1,6 @@
+[
+    { "profile": "PRODIGY", "startAge": 27, "initTicks": 13.0, "accel": 1.00, "peakTicks": 16.0 },
+    { "profile": "STANDARD", "startAge": 29, "initTicks": 9.0, "accel": 1.75, "peakTicks": 16.0 },
+    { "profile": "VETERAN", "startAge": 32, "initTicks": 10.0, "accel": 1.50, "peakTicks": 16.0 },
+    { "profile": "IRONMAN", "startAge": 34, "initTicks": 10.0, "accel": 1.50, "peakTicks": 16.0 }
+]

package/dist/cjs/src/stat-config/index.d.ts

@@ -1,4 +1,5 @@
 import rolesJSON from './roles.json';
 import traitsJSON from './traits.json';
 import statCapsJSON from './stat-caps.json';
-export { rolesJSON, traitsJSON, statCapsJSON };
+import declineProfilesJSON from './decline-profiles.json';
+export { rolesJSON, traitsJSON, statCapsJSON, declineProfilesJSON };

package/dist/cjs/src/stat-config/index.js

@@ -3,10 +3,12 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.statCapsJSON = exports.traitsJSON = exports.rolesJSON = void 0;
+exports.declineProfilesJSON = exports.statCapsJSON = exports.traitsJSON = exports.rolesJSON = void 0;
 const roles_json_1 = __importDefault(require("./roles.json"));
 exports.rolesJSON = roles_json_1.default;
 const traits_json_1 = __importDefault(require("./traits.json"));
 exports.traitsJSON = traits_json_1.default;
 const stat_caps_json_1 = __importDefault(require("./stat-caps.json"));
 exports.statCapsJSON = stat_caps_json_1.default;
+const decline_profiles_json_1 = __importDefault(require("./decline-profiles.json"));
+exports.declineProfilesJSON = decline_profiles_json_1.default;

package/dist/esm/src/data/models/player.d.ts

@@ -1,7 +1,7 @@
 import * as Sequelize from 'sequelize';
 import { Model } from 'sequelize';
 import { BoxScoreAttributes, BoxScoreId, BoxScoreModel, BoxScoreTotalsId, BoxScoreTotalsModel, CompetitionMVPId, CompetitionMVPModel, CountryId, CountryModel, MatchSetId, MatchSetModel, PerformanceStatsAttributes, PerformanceStatsId, PerformanceStatsModel, PlayerTeamId, PlayerTeamModel, TeamId, TeamModel, VPERId, VPERModel } from '.';
-import { Rarity, Role, Trait } from '../../service';
+import { DeclineProfile, Rarity, Role, Trait } from '../../service';
 export interface PlayerAttributes {
     player_id: string;
     roles: Role[];
@@ -10,6 +10,8 @@ export interface PlayerAttributes {
     first_name: string;
     last_name: string;
     country_id: string;
+    age: number;
+    decline_profile: DeclineProfile;
     PerformanceStat?: PerformanceStatsAttributes;
     BoxScores?: BoxScoreAttributes[];
 }
@@ -24,6 +26,8 @@ export declare class PlayerModel extends Model<PlayerAttributes, PlayerCreationA
     first_name: string;
     last_name: string;
     country_id: string;
+    age: number;
+    decline_profile: DeclineProfile;
     country: CountryModel;
     getCountry: Sequelize.BelongsToGetAssociationMixin<CountryModel>;
     setCountry: Sequelize.BelongsToSetAssociationMixin<CountryModel, CountryId>;

package/dist/esm/src/data/models/player.js

@@ -1,6 +1,6 @@
 import { DataTypes, Model } from 'sequelize';
 import { CountryModel, PerformanceStatsModel } from '.';
-import { RarityEnum, RoleEnum, TraitEnum } from '../../service';
+import { DeclineProfileEnum, RarityEnum, RoleEnum, TraitEnum } from '../../service';
 export class PlayerModel extends Model {
     static initModel(sequelize) {
         return PlayerModel.init({
@@ -36,6 +36,16 @@ export class PlayerModel extends Model {
                     model: 'Country',
                     key: 'country_id'
                 }
+            },
+            age: {
+                type: DataTypes.INTEGER,
+                allowNull: false,
+                defaultValue: 17
+            },
+            decline_profile: {
+                type: DataTypes.ENUM(...Object.values(DeclineProfileEnum)),
+                allowNull: false,
+                defaultValue: DeclineProfileEnum.STANDARD
             }
         }, {
             sequelize,

package/dist/esm/src/data/transformers/player.js

@@ -16,7 +16,9 @@ function transformToAttributes(player) {
         roles: player.roles,
         traits: player.traits,
         PerformanceStat: transformFromPerformanceStats(player.stats, player.id),
-        rarity: player.rarity
+        rarity: player.rarity,
+        age: player.age,
+        decline_profile: player.declineProfile
     };
 }
 function transformToBoxScoreTotals(model) {
@@ -75,6 +77,8 @@ function transformToObject(model) {
         traits: model.traits,
         stats: transformToPerformanceStats(model.PerformanceStat),
         rarity: model.rarity,
+        age: model.age,
+        declineProfile: model.decline_profile,
         boxScores: (model.BoxScores ?? []).map(transformToBoxScore),
         boxScoreTotals
     });

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

@@ -0,0 +1,43 @@
+import { PerformanceStatsKey } from './performance-stats-keys';
+export declare enum DeclineProfileEnum {
+    PRODIGY = "PRODIGY",
+    STANDARD = "STANDARD",
+    VETERAN = "VETERAN",
+    IRONMAN = "IRONMAN"
+}
+export type DeclineProfile = DeclineProfileEnum.PRODIGY | DeclineProfileEnum.STANDARD | DeclineProfileEnum.VETERAN | DeclineProfileEnum.IRONMAN;
+export declare const declineProfiles: DeclineProfileEnum[];
+interface DeclineProfileEntry {
+    profile: string;
+    startAge: number;
+    initTicks: number;
+    accel: number;
+    peakTicks: number;
+}
+/**
+ * Stats that decline first (technique / skill). One random stat from this pool is
+ * removed per tick during the pre-peak decline phase.
+ */
+export declare const SKILL_POOL: PerformanceStatsKey[];
+/**
+ * Energy / reaction stats (incl. crit-chance stats). These only start declining
+ * once the player reaches peak decline, alongside the skill pool.
+ */
+export declare const ENERGY_POOL: PerformanceStatsKey[];
+export declare function getDeclineProfile(profile: DeclineProfile): DeclineProfileEntry;
+export type DeclineStatus = 'ACTIVE' | 'DECLINING' | 'PEAK';
+export interface DeclineTick {
+    /** Number of decline ticks to apply this iteration. */
+    ticks: number;
+    /** True once tick rate hits the profile ceiling — both pools decline and training is blocked. */
+    atPeak: boolean;
+    /** Coarse status for display / gating. */
+    status: DeclineStatus;
+}
+/**
+ * Decline is fully derivable from age + profile — no running state is persisted.
+ *   tickRate = min(peakTicks, initTicks + (age - startAge) * accel)
+ * Pre-peak: `ticks` random SKILL stats lost. At peak: `ticks` from BOTH pools + training blocked.
+ */
+export declare function computeDeclineTick(age: number, profile: DeclineProfile): DeclineTick;
+export {};

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

@@ -0,0 +1,50 @@
+import { declineProfilesJSON } from '../../stat-config';
+export var DeclineProfileEnum;
+(function (DeclineProfileEnum) {
+    DeclineProfileEnum["PRODIGY"] = "PRODIGY";
+    DeclineProfileEnum["STANDARD"] = "STANDARD";
+    DeclineProfileEnum["VETERAN"] = "VETERAN";
+    DeclineProfileEnum["IRONMAN"] = "IRONMAN";
+})(DeclineProfileEnum || (DeclineProfileEnum = {}));
+export const declineProfiles = Object.values(DeclineProfileEnum);
+const profileEntries = declineProfilesJSON;
+/**
+ * Stats that decline first (technique / skill). One random stat from this pool is
+ * removed per tick during the pre-peak decline phase.
+ */
+export const SKILL_POOL = [
+    'setting', 'serve', 'spike', 'quick', 'power', 'backAttack',
+    'reception', 'overhand', 'bump', 'block', 'attack', 'defense'
+];
+/**
+ * Energy / reaction stats (incl. crit-chance stats). These only start declining
+ * once the player reaches peak decline, alongside the skill pool.
+ */
+export const ENERGY_POOL = [
+    'stamina', 'reflex', 'read', 'commit', 'awareness', 'focus'
+];
+export function getDeclineProfile(profile) {
+    const entry = profileEntries.find(e => e.profile === profile);
+    if (entry == null)
+        throw new Error(`UNKNOWN_DECLINE_PROFILE: ${profile}`);
+    return entry;
+}
+/**
+ * Decline is fully derivable from age + profile — no running state is persisted.
+ *   tickRate = min(peakTicks, initTicks + (age - startAge) * accel)
+ * Pre-peak: `ticks` random SKILL stats lost. At peak: `ticks` from BOTH pools + training blocked.
+ */
+export function computeDeclineTick(age, profile) {
+    const { startAge, initTicks, accel, peakTicks } = getDeclineProfile(profile);
+    if (age < startAge) {
+        return { ticks: 0, atPeak: false, status: 'ACTIVE' };
+    }
+    const rawRate = initTicks + (age - startAge) * accel;
+    const tickRate = Math.min(peakTicks, rawRate);
+    const atPeak = rawRate >= peakTicks;
+    return {
+        ticks: Math.round(tickRate),
+        atPeak,
+        status: atPeak ? 'PEAK' : 'DECLINING'
+    };
+}

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

@@ -1,5 +1,6 @@
 export * from './player';
 export * from './improvement';
+export * from './decline';
 export * from './player-generator';
 export * from './performance-stats';
 export * from './trait';

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

@@ -1,5 +1,6 @@
 export * from './player';
 export * from './improvement';
+export * from './decline';
 export * from './player-generator';
 export * from './performance-stats';
 export * from './trait';

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

@@ -8,6 +8,7 @@ import { rolesJSON } from '../../stat-config';
 import { shuffle, generatePlayerName } from '../utils';
 import { Player } from './player';
 import { assignTraits } from './trait';
+import { declineProfiles } from './decline';
 const LEGENDARY_PITY_STEP = 0.004;
 const MYTHIC_PITY_STEP = 0.00001;
 const SPECIAL_PITY_STEP = 0.000005;
@@ -110,12 +111,12 @@ export class PlayerGenerator {
         const BLOCK = getMultipliers(StatsEnum.BLOCK);
         const SERVE = getMultipliers(StatsEnum.SERVE);
         const STAMINA = getMultipliers(StatsEnum.STAMINA);
-        function buildPerformanceFromRole(weights, maxValue) {
+        function buildPerformanceFromRole(weights, minValue, maxValue) {
             return PerformanceStats.create(Object.fromEntries(performanceStatKeys.map((key) => {
                 if (weights[key] > 0)
-                    return [key, maxValue];
+                    return [key, randomInt(minValue, maxValue + 1)];
                 else
-                    return [key, Math.round(randomInt(RarityRanges.COMMON[0], maxValue - 5))];
+                    return [key, randomInt(RarityRanges.COMMON[0], Math.max(minValue - 1, RarityRanges.COMMON[0] + 1))];
             })));
         }
         switch (rarity) {
@@ -123,7 +124,7 @@ export class PlayerGenerator {
                 if (role != null) {
                     const weights = rolesJSON.find(entry => entry.role === role)?.weight;
                     if (weights != null) {
-                        return buildPerformanceFromRole(weights, RarityRanges.COMMON[1]);
+                        return buildPerformanceFromRole(weights, RarityRanges.COMMON[0], RarityRanges.COMMON[1]);
                     }
                 }
                 return PerformanceStats.create(Object.fromEntries(performanceStatKeys.map((key) => [key, Math.round(randomInt(RarityRanges.COMMON[0], RarityRanges.COMMON[1]))])));
@@ -132,7 +133,7 @@ export class PlayerGenerator {
                 if (role != null) {
                     const weights = rolesJSON.find(entry => entry.role === role)?.weight;
                     if (weights != null) {
-                        return buildPerformanceFromRole(weights, RarityRanges.RARE[1]);
+                        return buildPerformanceFromRole(weights, RarityRanges.RARE[0], RarityRanges.RARE[1]);
                     }
                 }
                 const stats = shuffle([ATTACK, SET, SERVE, RECEIVE, BLOCK]);
@@ -150,7 +151,7 @@ export class PlayerGenerator {
                 if (role != null) {
                     const weights = rolesJSON.find(entry => entry.role === role)?.weight;
                     if (weights != null) {
-                        return buildPerformanceFromRole(weights, RarityRanges.LEGENDARY[1]);
+                        return buildPerformanceFromRole(weights, RarityRanges.LEGENDARY[0], RarityRanges.LEGENDARY[1]);
                     }
                 }
                 const s1 = shuffle([ATTACK, SET, RECEIVE, BLOCK]);
@@ -169,7 +170,7 @@ export class PlayerGenerator {
                 if (role != null) {
                     const weights = rolesJSON.find(entry => entry.role === role)?.weight;
                     if (weights != null) {
-                        return buildPerformanceFromRole(weights, RarityRanges.MYTHIC[1]);
+                        return buildPerformanceFromRole(weights, RarityRanges.MYTHIC[0], RarityRanges.MYTHIC[1]);
                     }
                 }
                 const stats = shuffle([ATTACK, SET, RECEIVE, BLOCK]);
@@ -187,7 +188,7 @@ export class PlayerGenerator {
                 if (role != null) {
                     const weights = rolesJSON.find(entry => entry.role === role)?.weight;
                     if (weights != null) {
-                        return buildPerformanceFromRole(weights, RarityRanges.SPECIAL[1]);
+                        return buildPerformanceFromRole(weights, RarityRanges.SPECIAL[0], RarityRanges.SPECIAL[1]);
                     }
                 }
                 const stats = shuffle([ATTACK, SERVE, SET, RECEIVE, BLOCK]);
@@ -213,7 +214,9 @@ export class PlayerGenerator {
         const stats = PlayerGenerator.generatePerformance(rarity, role);
         const roles = assignRoles(stats, rarity);
         const traits = assignTraits(roles, rarity, maxTraits);
-        return Player.create({ id: uuidv4(), name, country, stats, roles, traits, rarity });
+        const age = randomInt(15, 21);
+        const declineProfile = declineProfiles[randomInt(0, declineProfiles.length)];
+        return Player.create({ id: uuidv4(), name, country, stats, roles, traits, rarity, age, declineProfile });
     }
     static generatePlayers(count, countries) {
         const players = [];

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

@@ -5,6 +5,7 @@ import { Rarity } from './rarity';
 import { Stats } from './stats';
 import { Role } from './role';
 import { BoxScore, BoxScoreTotals } from '../match';
+import { DeclineProfile } from './decline';
 export declare class Stat {
     readonly name: Stats;
     readonly value: number;
@@ -30,6 +31,8 @@ export declare class Player {
     readonly traits: Trait[];
     readonly generalStats: Stat[];
     readonly rarity: Rarity;
+    readonly age: number;
+    readonly declineProfile: DeclineProfile;
     readonly boxScores?: BoxScore[];
     readonly boxScoreTotals?: BoxScoreTotals;
     static create(input: unknown): Player;

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

@@ -49,7 +49,7 @@ export class Player {
             stats: PerformanceStats.create(result.data.stats)
         });
     }
-    constructor({ id, name, country, stats, roles, traits, rarity, boxScores, boxScoreTotals }) {
+    constructor({ id, name, country, stats, roles, traits, rarity, age, declineProfile, boxScores, boxScoreTotals }) {
         this.id = id;
         this.name = name;
         this.country = country;
@@ -57,6 +57,8 @@ export class Player {
         this.roles = roles;
         this.traits = traits;
         this.rarity = rarity;
+        this.age = age;
+        this.declineProfile = declineProfile;
         this.boxScores = boxScores;
         this.boxScoreTotals = boxScoreTotals;
         this.generalStats = Object.values(StatsEnum).map((stat) => ({

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

@@ -3,6 +3,7 @@ import { Country } from '../../country';
 import { RoleEnum } from '../role';
 import { TraitEnum } from '../trait';
 import { RarityEnum } from '../rarity';
+import { DeclineProfileEnum } from '../decline';
 export declare const NameInputSchema: z.ZodObject<{
     first: z.ZodString;
     last: z.ZodString;
@@ -59,6 +60,13 @@ export declare const PlayerInputSchema: z.ZodObject<{
         MYTHIC: RarityEnum.MYTHIC;
         SPECIAL: RarityEnum.SPECIAL;
     }>;
+    age: z.ZodNumber;
+    declineProfile: z.ZodEnum<{
+        PRODIGY: DeclineProfileEnum.PRODIGY;
+        STANDARD: DeclineProfileEnum.STANDARD;
+        VETERAN: DeclineProfileEnum.VETERAN;
+        IRONMAN: DeclineProfileEnum.IRONMAN;
+    }>;
     boxScores: z.ZodOptional<z.ZodArray<z.ZodObject<{
         playerId: z.ZodUUID;
         matchSetId: z.ZodUUID;

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

@@ -3,6 +3,7 @@ import { Country } from '../../country';
 import { RoleEnum } from '../role';
 import { TraitEnum } from '../trait';
 import { RarityEnum } from '../rarity';
+import { DeclineProfileEnum } from '../decline';
 import { AttackStatsSchema, BlockStatsSchema, BoxScoreInputSchema, DefenseStatsSchema, MiscStatsSchema, ReceptionStatsSchema, ServeStatsSchema, SettingStatsSchema } from '../../match/schemas/box-score.z';
 import { PerformanceStatsInputSchema } from './performance-stats.z';
 export const NameInputSchema = z.object({
@@ -29,6 +30,8 @@ export const PlayerInputSchema = z.object({
     roles: z.array(z.enum(Object.values(RoleEnum))).min(1),
     traits: z.array(z.enum(Object.values(TraitEnum))),
     rarity: z.enum(Object.values(RarityEnum)),
+    age: z.number().int().min(0),
+    declineProfile: z.enum(Object.values(DeclineProfileEnum)),
     boxScores: z.array(BoxScoreInputSchema).optional(),
     boxScoreTotals: BoxScoreTotalsInputSchema.optional()
 });

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

@@ -11,6 +11,7 @@ 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() {
@@ -33,7 +34,9 @@ export function makePlayer(country, statValue = 50) {
         stats,
         roles: [RoleEnum.OUTSIDE_HITTER],
         traits: [],
-        rarity: RarityEnum.COMMON
+        rarity: RarityEnum.COMMON,
+        age: 20,
+        declineProfile: DeclineProfileEnum.STANDARD
     });
 }
 // ─── Team ─────────────────────────────────────────────────────────────────────

package/dist/esm/src/stat-config/decline-profiles.json

@@ -0,0 +1,6 @@
+[
+    { "profile": "PRODIGY", "startAge": 27, "initTicks": 13.0, "accel": 1.00, "peakTicks": 16.0 },
+    { "profile": "STANDARD", "startAge": 29, "initTicks": 9.0, "accel": 1.75, "peakTicks": 16.0 },
+    { "profile": "VETERAN", "startAge": 32, "initTicks": 10.0, "accel": 1.50, "peakTicks": 16.0 },
+    { "profile": "IRONMAN", "startAge": 34, "initTicks": 10.0, "accel": 1.50, "peakTicks": 16.0 }
+]

package/dist/esm/src/stat-config/index.d.ts

@@ -1,4 +1,5 @@
 import rolesJSON from './roles.json';
 import traitsJSON from './traits.json';
 import statCapsJSON from './stat-caps.json';
-export { rolesJSON, traitsJSON, statCapsJSON };
+import declineProfilesJSON from './decline-profiles.json';
+export { rolesJSON, traitsJSON, statCapsJSON, declineProfilesJSON };

package/dist/esm/src/stat-config/index.js

@@ -1,4 +1,5 @@
 import rolesJSON from './roles.json';
 import traitsJSON from './traits.json';
 import statCapsJSON from './stat-caps.json';
-export { rolesJSON, traitsJSON, statCapsJSON };
+import declineProfilesJSON from './decline-profiles.json';
+export { rolesJSON, traitsJSON, statCapsJSON, declineProfilesJSON };

package/package.json

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