volleyballsimtypes 0.0.360 → 0.0.363

package/dist/cjs/src/api/index.d.ts

@@ -1,4 +1,4 @@
-import { BoxScore, DataProps, Division as _Division, League as _League, Match as _Match, MatchSet as _MatchSet, Player as _Player, PlayerPosition, Qualifier as _Qualifier, QualifierMatch as _QualifierMatch, Rally as _Rally, RallyEvent as _RallyEvent, Season as _Season, Standing as _Standing, Team as _Team, Tournament as _Tournament, TournamentMatch as _TournamentMatch, Country as _Country, CourtPosition } from '../service';
+import { BoxScore, DataProps, DeclineStatus, Division as _Division, League as _League, Match as _Match, MatchSet as _MatchSet, Player as _Player, PlayerPosition, Qualifier as _Qualifier, QualifierMatch as _QualifierMatch, Rally as _Rally, RallyEvent as _RallyEvent, Season as _Season, Standing as _Standing, Team as _Team, Tournament as _Tournament, TournamentMatch as _TournamentMatch, Country as _Country, CourtPosition } from '../service';
 export type Rally = DataProps<_Rally> & {
     homePlayerPosition: PlayerPosition[];
     awayPlayerPosition: PlayerPosition[];
@@ -33,6 +33,7 @@ export type Player = DataProps<_Player> & {
     teamId: string;
     jerseyNumber: number;
     locked: boolean;
+    declineStatus: DeclineStatus;
 };
 export interface StartingLineup {
     [CourtPosition.LEFT_FRONT]: string;

package/dist/cjs/src/data/init-models.js

@@ -40,6 +40,7 @@ function initModels(sequelize) {
     const Player = models_1.PlayerModel.initModel(sequelize);
     const PlayerImprovementLog = models_1.PlayerImprovementLogModel.initModel(sequelize);
     const PlayerTeam = models_1.PlayerTeamModel.initModel(sequelize);
+    const RetiredPlayer = models_1.RetiredPlayerModel.initModel(sequelize);
     const Rally = models_1.RallyModel.initModel(sequelize);
     const PromotionMatch = models_1.PromotionMatchModel.initModel(sequelize);
     const RegionQualifier = models_1.RegionQualifierModel.initModel(sequelize);
@@ -168,6 +169,9 @@ function initModels(sequelize) {
     Player.hasOne(BoxScoreTotals, { as: 'BoxScoreTotals', foreignKey: 'player_id' });
     PlayerTeam.belongsTo(Player, { as: 'player', foreignKey: 'player_id' });
     PlayerTeam.belongsTo(Team, { as: 'team', foreignKey: 'team_id' });
+    RetiredPlayer.belongsTo(Player, { as: 'player', foreignKey: 'player_id' });
+    RetiredPlayer.belongsTo(Team, { as: 'team', foreignKey: 'team_id' });
+    Player.hasOne(RetiredPlayer, { as: 'RetiredPlayer', foreignKey: 'player_id' });
     Rally.belongsTo(MatchSet, { as: 'matchSet', foreignKey: 'match_set_id' });
     Rally.belongsTo(Team, { as: 'ServingTeam', foreignKey: 'serving_team' });
     PromotionMatch.belongsTo(Iteration, { as: 'iterationData', foreignKey: 'iteration' });
@@ -242,6 +246,7 @@ function initModels(sequelize) {
         PerformanceStats,
         Player,
         PlayerTeam,
+        RetiredPlayer,
         PlayerImprovementLog,
         PromotionMatch,
         RegionQualifier,

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

@@ -23,6 +23,7 @@ export * from './performance-stats';
 export * from './player';
 export * from './player-improvement-log';
 export * from './player-team';
+export * from './retired-player';
 export * from './rally';
 export * from './promotion-match';
 export * from './region-qualifier';

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

@@ -39,6 +39,7 @@ __exportStar(require("./performance-stats"), exports);
 __exportStar(require("./player"), exports);
 __exportStar(require("./player-improvement-log"), exports);
 __exportStar(require("./player-team"), exports);
+__exportStar(require("./retired-player"), exports);
 __exportStar(require("./rally"), exports);
 __exportStar(require("./promotion-match"), exports);
 __exportStar(require("./region-qualifier"), exports);

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

@@ -0,0 +1,27 @@
+import * as Sequelize from 'sequelize';
+import { Model } from 'sequelize';
+import { PlayerId, PlayerModel, TeamId, TeamModel } from '.';
+export interface RetiredPlayerAttributes {
+    player_id: string;
+    user_id: string;
+    team_id: string;
+    retired_iteration: number;
+}
+export type RetiredPlayerPk = 'player_id';
+export type RetiredPlayerId = RetiredPlayerModel[RetiredPlayerPk];
+export type RetiredPlayerCreationAttributes = RetiredPlayerAttributes;
+export declare class RetiredPlayerModel extends Model<RetiredPlayerAttributes, RetiredPlayerCreationAttributes> implements RetiredPlayerAttributes {
+    player_id: string;
+    user_id: string;
+    team_id: string;
+    retired_iteration: number;
+    player: PlayerModel;
+    getPlayer: Sequelize.BelongsToGetAssociationMixin<PlayerModel>;
+    setPlayer: Sequelize.BelongsToSetAssociationMixin<PlayerModel, PlayerId>;
+    createPlayer: Sequelize.BelongsToCreateAssociationMixin<PlayerModel>;
+    team: TeamModel;
+    getTeam: Sequelize.BelongsToGetAssociationMixin<TeamModel>;
+    setTeam: Sequelize.BelongsToSetAssociationMixin<TeamModel, TeamId>;
+    createTeam: Sequelize.BelongsToCreateAssociationMixin<TeamModel>;
+    static initModel(sequelize: Sequelize.Sequelize): typeof RetiredPlayerModel;
+}

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

@@ -0,0 +1,50 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RetiredPlayerModel = void 0;
+const sequelize_1 = require("sequelize");
+class RetiredPlayerModel extends sequelize_1.Model {
+    static initModel(sequelize) {
+        return RetiredPlayerModel.init({
+            player_id: {
+                type: sequelize_1.DataTypes.UUID,
+                allowNull: false,
+                primaryKey: true,
+                references: {
+                    model: 'Player',
+                    key: 'player_id'
+                }
+            },
+            user_id: {
+                type: sequelize_1.DataTypes.UUID,
+                allowNull: false,
+                references: {
+                    model: 'AuthUser',
+                    key: 'user_id'
+                }
+            },
+            team_id: {
+                type: sequelize_1.DataTypes.UUID,
+                allowNull: false,
+                references: {
+                    model: 'Team',
+                    key: 'team_id'
+                }
+            },
+            retired_iteration: {
+                type: sequelize_1.DataTypes.INTEGER,
+                allowNull: false
+            }
+        }, {
+            sequelize,
+            tableName: 'RetiredPlayer',
+            schema: 'public',
+            timestamps: false,
+            indexes: [{
+                    name: 'RetiredPlayer_pk',
+                    unique: true,
+                    fields: [{ name: 'player_id' }]
+                }]
+        });
+    }
+}
+exports.RetiredPlayerModel = RetiredPlayerModel;

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

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

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

@@ -0,0 +1,102 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const globals_1 = require("@jest/globals");
+const decline_1 = require("./decline");
+const performance_stats_keys_1 = require("./performance-stats-keys");
+// ─── getDeclineProfile ─────────────────────────────────────────────────────────
+(0, globals_1.describe)('getDeclineProfile()', () => {
+    globals_1.it.each([
+        [decline_1.DeclineProfileEnum.PRODIGY, 27, 13.0, 1.0, 16.0],
+        [decline_1.DeclineProfileEnum.STANDARD, 29, 9.0, 1.75, 16.0],
+        [decline_1.DeclineProfileEnum.VETERAN, 32, 10.0, 1.5, 16.0],
+        [decline_1.DeclineProfileEnum.IRONMAN, 34, 10.0, 1.5, 16.0]
+    ])('%s → startAge %i', (profile, startAge, initTicks, accel, peakTicks) => {
+        const entry = (0, decline_1.getDeclineProfile)(profile);
+        (0, globals_1.expect)(entry.startAge).toBe(startAge);
+        (0, globals_1.expect)(entry.initTicks).toBeCloseTo(initTicks, 5);
+        (0, globals_1.expect)(entry.accel).toBeCloseTo(accel, 5);
+        (0, globals_1.expect)(entry.peakTicks).toBeCloseTo(peakTicks, 5);
+    });
+    (0, globals_1.it)('throws UNKNOWN_DECLINE_PROFILE for an unrecognised profile', () => {
+        (0, globals_1.expect)(() => (0, decline_1.getDeclineProfile)('LEGEND')).toThrow('UNKNOWN_DECLINE_PROFILE');
+    });
+    (0, globals_1.it)('declineProfiles lists all four enum values', () => {
+        (0, globals_1.expect)([...decline_1.declineProfiles].sort()).toEqual([...Object.values(decline_1.DeclineProfileEnum)].sort());
+    });
+});
+// ─── stat pools ────────────────────────────────────────────────────────────────
+(0, globals_1.describe)('decline stat pools', () => {
+    (0, globals_1.it)('SKILL_POOL and ENERGY_POOL are disjoint', () => {
+        const overlap = decline_1.SKILL_POOL.filter(k => decline_1.ENERGY_POOL.includes(k));
+        (0, globals_1.expect)(overlap).toEqual([]);
+    });
+    (0, globals_1.it)('together they cover every performance stat key exactly once', () => {
+        const union = [...decline_1.SKILL_POOL, ...decline_1.ENERGY_POOL].sort();
+        (0, globals_1.expect)(union).toEqual([...performance_stats_keys_1.performanceStatKeys].sort());
+    });
+    (0, globals_1.it)('ENERGY_POOL holds the reaction/energy stats (incl. crit-chance stats)', () => {
+        (0, globals_1.expect)([...decline_1.ENERGY_POOL].sort()).toEqual(['awareness', 'commit', 'focus', 'read', 'reflex', 'stamina'].sort());
+    });
+});
+// ─── computeDeclineTick ────────────────────────────────────────────────────────
+(0, globals_1.describe)('computeDeclineTick()', () => {
+    (0, globals_1.it)('returns no decline before the profile start age', () => {
+        for (const profile of decline_1.declineProfiles) {
+            const { startAge } = (0, decline_1.getDeclineProfile)(profile);
+            const tick = (0, decline_1.computeDeclineTick)(startAge - 1, profile);
+            (0, globals_1.expect)(tick.ticks).toBe(0);
+            (0, globals_1.expect)(tick.atPeak).toBe(false);
+            (0, globals_1.expect)(tick.status).toBe('ACTIVE');
+        }
+    });
+    (0, globals_1.it)('at the start age, tick rate equals round(initTicks) and status is DECLINING', () => {
+        for (const profile of decline_1.declineProfiles) {
+            const { startAge, initTicks } = (0, decline_1.getDeclineProfile)(profile);
+            const tick = (0, decline_1.computeDeclineTick)(startAge, profile);
+            (0, globals_1.expect)(tick.ticks).toBe(Math.round(initTicks));
+            (0, globals_1.expect)(tick.atPeak).toBe(false);
+            (0, globals_1.expect)(tick.status).toBe('DECLINING');
+        }
+    });
+    (0, globals_1.it)('tick count is non-decreasing as age increases', () => {
+        for (const profile of decline_1.declineProfiles) {
+            const { startAge } = (0, decline_1.getDeclineProfile)(profile);
+            let prev = -1;
+            for (let age = startAge; age <= startAge + 30; age++) {
+                const { ticks } = (0, decline_1.computeDeclineTick)(age, profile);
+                (0, globals_1.expect)(ticks).toBeGreaterThanOrEqual(prev);
+                prev = ticks;
+            }
+        }
+    });
+    (0, globals_1.it)('never exceeds peakTicks, and reaching it flips atPeak / PEAK', () => {
+        for (const profile of decline_1.declineProfiles) {
+            const { startAge, peakTicks } = (0, decline_1.getDeclineProfile)(profile);
+            for (let age = startAge; age <= startAge + 40; age++) {
+                const tick = (0, decline_1.computeDeclineTick)(age, profile);
+                (0, globals_1.expect)(tick.ticks).toBeLessThanOrEqual(Math.round(peakTicks));
+                if (tick.atPeak) {
+                    (0, globals_1.expect)(tick.ticks).toBe(Math.round(peakTicks));
+                    (0, globals_1.expect)(tick.status).toBe('PEAK');
+                }
+            }
+        }
+    });
+    (0, globals_1.it)('peak triggers at the analytically expected age for each profile', () => {
+        // age at peak = startAge + ceil((peakTicks - initTicks) / accel)
+        for (const profile of decline_1.declineProfiles) {
+            const { startAge, initTicks, accel, peakTicks } = (0, decline_1.getDeclineProfile)(profile);
+            const peakAge = startAge + Math.ceil((peakTicks - initTicks) / accel);
+            (0, globals_1.expect)((0, decline_1.computeDeclineTick)(peakAge - 1, profile).atPeak).toBe(false);
+            (0, globals_1.expect)((0, decline_1.computeDeclineTick)(peakAge, profile).atPeak).toBe(true);
+        }
+    });
+    (0, globals_1.it)('Standard profile matches the validated model at key ages', () => {
+        // initTicks 9, accel 1.75, peakTicks 16, startAge 29
+        (0, globals_1.expect)((0, decline_1.computeDeclineTick)(28, decline_1.DeclineProfileEnum.STANDARD)).toEqual({ ticks: 0, atPeak: false, status: 'ACTIVE' });
+        (0, globals_1.expect)((0, decline_1.computeDeclineTick)(29, decline_1.DeclineProfileEnum.STANDARD).ticks).toBe(9);
+        (0, globals_1.expect)((0, decline_1.computeDeclineTick)(30, decline_1.DeclineProfileEnum.STANDARD).ticks).toBe(Math.round(9 + 1.75)); // 11
+        // 9 + 4*1.75 = 16 → peak at age 33
+        (0, globals_1.expect)((0, decline_1.computeDeclineTick)(33, decline_1.DeclineProfileEnum.STANDARD).atPeak).toBe(true);
+    });
+});

package/dist/esm/src/api/index.d.ts

@@ -1,4 +1,4 @@
-import { BoxScore, DataProps, Division as _Division, League as _League, Match as _Match, MatchSet as _MatchSet, Player as _Player, PlayerPosition, Qualifier as _Qualifier, QualifierMatch as _QualifierMatch, Rally as _Rally, RallyEvent as _RallyEvent, Season as _Season, Standing as _Standing, Team as _Team, Tournament as _Tournament, TournamentMatch as _TournamentMatch, Country as _Country, CourtPosition } from '../service';
+import { BoxScore, DataProps, DeclineStatus, Division as _Division, League as _League, Match as _Match, MatchSet as _MatchSet, Player as _Player, PlayerPosition, Qualifier as _Qualifier, QualifierMatch as _QualifierMatch, Rally as _Rally, RallyEvent as _RallyEvent, Season as _Season, Standing as _Standing, Team as _Team, Tournament as _Tournament, TournamentMatch as _TournamentMatch, Country as _Country, CourtPosition } from '../service';
 export type Rally = DataProps<_Rally> & {
     homePlayerPosition: PlayerPosition[];
     awayPlayerPosition: PlayerPosition[];
@@ -33,6 +33,7 @@ export type Player = DataProps<_Player> & {
     teamId: string;
     jerseyNumber: number;
     locked: boolean;
+    declineStatus: DeclineStatus;
 };
 export interface StartingLineup {
     [CourtPosition.LEFT_FRONT]: string;

package/dist/esm/src/data/init-models.js

@@ -1,4 +1,4 @@
-import { AuthIdentityModel, AuthSessionModel, AuthUserModel, BoxScoreModel, CoachModel, BoxScoreTotalsModel, CompetitionChampionModel, CurrencyTransactionModel, GachaPityModel, GachaPullHistoryModel, WishlistModel, UserSettingsModel, CompetitionMatchModel, CompetitionMVPModel, CompetitionModel, CompetitionStandingsMatchModel, CompetitionStandingsModel, CompetitionTeamsModel, CountryModel, DivisionModel, DivisionSeasonModel, IterationModel, LeagueModel, MatchModel, MatchRatingModel, MatchResultModel, MatchSetModel, PerformanceStatsModel, PlayerModel, PlayerImprovementLogModel, PlayerTeamModel, PromotionMatchModel, RegionQualifierModel, RallyModel, TacticsModel, TeamModel, TeamReplacementModel, UserCurrencyModel, UserPlayerProgressModel, UserPullGrantModel, UserTeamModel, VPERModel, NotificationModel } from './models';
+import { AuthIdentityModel, AuthSessionModel, AuthUserModel, BoxScoreModel, CoachModel, BoxScoreTotalsModel, CompetitionChampionModel, CurrencyTransactionModel, GachaPityModel, GachaPullHistoryModel, WishlistModel, UserSettingsModel, CompetitionMatchModel, CompetitionMVPModel, CompetitionModel, CompetitionStandingsMatchModel, CompetitionStandingsModel, CompetitionTeamsModel, CountryModel, DivisionModel, DivisionSeasonModel, IterationModel, LeagueModel, MatchModel, MatchRatingModel, MatchResultModel, MatchSetModel, PerformanceStatsModel, PlayerModel, PlayerImprovementLogModel, PlayerTeamModel, RetiredPlayerModel, PromotionMatchModel, RegionQualifierModel, RallyModel, TacticsModel, TeamModel, TeamReplacementModel, UserCurrencyModel, UserPlayerProgressModel, UserPullGrantModel, UserTeamModel, VPERModel, NotificationModel } from './models';
 export function initModels(sequelize) {
     const Coach = CoachModel.initModel(sequelize);
     const CurrencyTransaction = CurrencyTransactionModel.initModel(sequelize);
@@ -37,6 +37,7 @@ export function initModels(sequelize) {
     const Player = PlayerModel.initModel(sequelize);
     const PlayerImprovementLog = PlayerImprovementLogModel.initModel(sequelize);
     const PlayerTeam = PlayerTeamModel.initModel(sequelize);
+    const RetiredPlayer = RetiredPlayerModel.initModel(sequelize);
     const Rally = RallyModel.initModel(sequelize);
     const PromotionMatch = PromotionMatchModel.initModel(sequelize);
     const RegionQualifier = RegionQualifierModel.initModel(sequelize);
@@ -165,6 +166,9 @@ export function initModels(sequelize) {
     Player.hasOne(BoxScoreTotals, { as: 'BoxScoreTotals', foreignKey: 'player_id' });
     PlayerTeam.belongsTo(Player, { as: 'player', foreignKey: 'player_id' });
     PlayerTeam.belongsTo(Team, { as: 'team', foreignKey: 'team_id' });
+    RetiredPlayer.belongsTo(Player, { as: 'player', foreignKey: 'player_id' });
+    RetiredPlayer.belongsTo(Team, { as: 'team', foreignKey: 'team_id' });
+    Player.hasOne(RetiredPlayer, { as: 'RetiredPlayer', foreignKey: 'player_id' });
     Rally.belongsTo(MatchSet, { as: 'matchSet', foreignKey: 'match_set_id' });
     Rally.belongsTo(Team, { as: 'ServingTeam', foreignKey: 'serving_team' });
     PromotionMatch.belongsTo(Iteration, { as: 'iterationData', foreignKey: 'iteration' });
@@ -239,6 +243,7 @@ export function initModels(sequelize) {
         PerformanceStats,
         Player,
         PlayerTeam,
+        RetiredPlayer,
         PlayerImprovementLog,
         PromotionMatch,
         RegionQualifier,

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

@@ -23,6 +23,7 @@ export * from './performance-stats';
 export * from './player';
 export * from './player-improvement-log';
 export * from './player-team';
+export * from './retired-player';
 export * from './rally';
 export * from './promotion-match';
 export * from './region-qualifier';

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

@@ -23,6 +23,7 @@ export * from './performance-stats';
 export * from './player';
 export * from './player-improvement-log';
 export * from './player-team';
+export * from './retired-player';
 export * from './rally';
 export * from './promotion-match';
 export * from './region-qualifier';

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

@@ -0,0 +1,27 @@
+import * as Sequelize from 'sequelize';
+import { Model } from 'sequelize';
+import { PlayerId, PlayerModel, TeamId, TeamModel } from '.';
+export interface RetiredPlayerAttributes {
+    player_id: string;
+    user_id: string;
+    team_id: string;
+    retired_iteration: number;
+}
+export type RetiredPlayerPk = 'player_id';
+export type RetiredPlayerId = RetiredPlayerModel[RetiredPlayerPk];
+export type RetiredPlayerCreationAttributes = RetiredPlayerAttributes;
+export declare class RetiredPlayerModel extends Model<RetiredPlayerAttributes, RetiredPlayerCreationAttributes> implements RetiredPlayerAttributes {
+    player_id: string;
+    user_id: string;
+    team_id: string;
+    retired_iteration: number;
+    player: PlayerModel;
+    getPlayer: Sequelize.BelongsToGetAssociationMixin<PlayerModel>;
+    setPlayer: Sequelize.BelongsToSetAssociationMixin<PlayerModel, PlayerId>;
+    createPlayer: Sequelize.BelongsToCreateAssociationMixin<PlayerModel>;
+    team: TeamModel;
+    getTeam: Sequelize.BelongsToGetAssociationMixin<TeamModel>;
+    setTeam: Sequelize.BelongsToSetAssociationMixin<TeamModel, TeamId>;
+    createTeam: Sequelize.BelongsToCreateAssociationMixin<TeamModel>;
+    static initModel(sequelize: Sequelize.Sequelize): typeof RetiredPlayerModel;
+}

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

@@ -0,0 +1,46 @@
+import { DataTypes, Model } from 'sequelize';
+export class RetiredPlayerModel extends Model {
+    static initModel(sequelize) {
+        return RetiredPlayerModel.init({
+            player_id: {
+                type: DataTypes.UUID,
+                allowNull: false,
+                primaryKey: true,
+                references: {
+                    model: 'Player',
+                    key: 'player_id'
+                }
+            },
+            user_id: {
+                type: DataTypes.UUID,
+                allowNull: false,
+                references: {
+                    model: 'AuthUser',
+                    key: 'user_id'
+                }
+            },
+            team_id: {
+                type: DataTypes.UUID,
+                allowNull: false,
+                references: {
+                    model: 'Team',
+                    key: 'team_id'
+                }
+            },
+            retired_iteration: {
+                type: DataTypes.INTEGER,
+                allowNull: false
+            }
+        }, {
+            sequelize,
+            tableName: 'RetiredPlayer',
+            schema: 'public',
+            timestamps: false,
+            indexes: [{
+                    name: 'RetiredPlayer_pk',
+                    unique: true,
+                    fields: [{ name: 'player_id' }]
+                }]
+        });
+    }
+}

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

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

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

@@ -0,0 +1,100 @@
+import { describe, it, expect } from '@jest/globals';
+import { DeclineProfileEnum, declineProfiles, getDeclineProfile, computeDeclineTick, SKILL_POOL, ENERGY_POOL } from './decline';
+import { performanceStatKeys } from './performance-stats-keys';
+// ─── getDeclineProfile ─────────────────────────────────────────────────────────
+describe('getDeclineProfile()', () => {
+    it.each([
+        [DeclineProfileEnum.PRODIGY, 27, 13.0, 1.0, 16.0],
+        [DeclineProfileEnum.STANDARD, 29, 9.0, 1.75, 16.0],
+        [DeclineProfileEnum.VETERAN, 32, 10.0, 1.5, 16.0],
+        [DeclineProfileEnum.IRONMAN, 34, 10.0, 1.5, 16.0]
+    ])('%s → startAge %i', (profile, startAge, initTicks, accel, peakTicks) => {
+        const entry = getDeclineProfile(profile);
+        expect(entry.startAge).toBe(startAge);
+        expect(entry.initTicks).toBeCloseTo(initTicks, 5);
+        expect(entry.accel).toBeCloseTo(accel, 5);
+        expect(entry.peakTicks).toBeCloseTo(peakTicks, 5);
+    });
+    it('throws UNKNOWN_DECLINE_PROFILE for an unrecognised profile', () => {
+        expect(() => getDeclineProfile('LEGEND')).toThrow('UNKNOWN_DECLINE_PROFILE');
+    });
+    it('declineProfiles lists all four enum values', () => {
+        expect([...declineProfiles].sort()).toEqual([...Object.values(DeclineProfileEnum)].sort());
+    });
+});
+// ─── stat pools ────────────────────────────────────────────────────────────────
+describe('decline stat pools', () => {
+    it('SKILL_POOL and ENERGY_POOL are disjoint', () => {
+        const overlap = SKILL_POOL.filter(k => ENERGY_POOL.includes(k));
+        expect(overlap).toEqual([]);
+    });
+    it('together they cover every performance stat key exactly once', () => {
+        const union = [...SKILL_POOL, ...ENERGY_POOL].sort();
+        expect(union).toEqual([...performanceStatKeys].sort());
+    });
+    it('ENERGY_POOL holds the reaction/energy stats (incl. crit-chance stats)', () => {
+        expect([...ENERGY_POOL].sort()).toEqual(['awareness', 'commit', 'focus', 'read', 'reflex', 'stamina'].sort());
+    });
+});
+// ─── computeDeclineTick ────────────────────────────────────────────────────────
+describe('computeDeclineTick()', () => {
+    it('returns no decline before the profile start age', () => {
+        for (const profile of declineProfiles) {
+            const { startAge } = getDeclineProfile(profile);
+            const tick = computeDeclineTick(startAge - 1, profile);
+            expect(tick.ticks).toBe(0);
+            expect(tick.atPeak).toBe(false);
+            expect(tick.status).toBe('ACTIVE');
+        }
+    });
+    it('at the start age, tick rate equals round(initTicks) and status is DECLINING', () => {
+        for (const profile of declineProfiles) {
+            const { startAge, initTicks } = getDeclineProfile(profile);
+            const tick = computeDeclineTick(startAge, profile);
+            expect(tick.ticks).toBe(Math.round(initTicks));
+            expect(tick.atPeak).toBe(false);
+            expect(tick.status).toBe('DECLINING');
+        }
+    });
+    it('tick count is non-decreasing as age increases', () => {
+        for (const profile of declineProfiles) {
+            const { startAge } = getDeclineProfile(profile);
+            let prev = -1;
+            for (let age = startAge; age <= startAge + 30; age++) {
+                const { ticks } = computeDeclineTick(age, profile);
+                expect(ticks).toBeGreaterThanOrEqual(prev);
+                prev = ticks;
+            }
+        }
+    });
+    it('never exceeds peakTicks, and reaching it flips atPeak / PEAK', () => {
+        for (const profile of declineProfiles) {
+            const { startAge, peakTicks } = getDeclineProfile(profile);
+            for (let age = startAge; age <= startAge + 40; age++) {
+                const tick = computeDeclineTick(age, profile);
+                expect(tick.ticks).toBeLessThanOrEqual(Math.round(peakTicks));
+                if (tick.atPeak) {
+                    expect(tick.ticks).toBe(Math.round(peakTicks));
+                    expect(tick.status).toBe('PEAK');
+                }
+            }
+        }
+    });
+    it('peak triggers at the analytically expected age for each profile', () => {
+        // age at peak = startAge + ceil((peakTicks - initTicks) / accel)
+        for (const profile of declineProfiles) {
+            const { startAge, initTicks, accel, peakTicks } = getDeclineProfile(profile);
+            const peakAge = startAge + Math.ceil((peakTicks - initTicks) / accel);
+            expect(computeDeclineTick(peakAge - 1, profile).atPeak).toBe(false);
+            expect(computeDeclineTick(peakAge, profile).atPeak).toBe(true);
+        }
+    });
+    it('Standard profile matches the validated model at key ages', () => {
+        // initTicks 9, accel 1.75, peakTicks 16, startAge 29
+        expect(computeDeclineTick(28, DeclineProfileEnum.STANDARD)).toEqual({ ticks: 0, atPeak: false, status: 'ACTIVE' });
+        expect(computeDeclineTick(29, DeclineProfileEnum.STANDARD).ticks).toBe(9);
+        expect(computeDeclineTick(30, DeclineProfileEnum.STANDARD).ticks).toBe(Math.round(9 + 1.75)); // 11
+        // 9 + 4*1.75 = 16 → peak at age 33
+        expect(computeDeclineTick(33, DeclineProfileEnum.STANDARD).atPeak).toBe(true);
+    });
+});

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "volleyballsimtypes",
-  "version": "0.0.360",
+  "version": "0.0.363",
   "description": "vbsim types",
   "main": "./dist/cjs/src/index.js",
   "module": "./dist/esm/src/index.js",
@@ -67,6 +67,7 @@
     "test-types": "npm run validate && npx jest --coverage --passWithNoTests",
     "build": "npm run test-types && yarn clean && tsc -p tsconfig.json && tsc -p tsconfig-cjs.json",
     "sync:consumers": "powershell -NoProfile -ExecutionPolicy Bypass -File ./scripts/sync-consumers.ps1",
+    "release": "powershell -NoProfile -ExecutionPolicy Bypass -File ./scripts/release.ps1",
     "export:schema": "powershell -NoProfile -ExecutionPolicy Bypass -File ./scripts/export-schema.ps1",
     "preversion": "npm run clean && npm run build && git commit -a --amend --no-edit",
     "postversion": "git push --follow-tags && npm login && npm publish"