volleyballsimtypes 0.0.425 → 0.0.427

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

@@ -24,6 +24,13 @@ export interface MatchCompetition {
     tier?: number;
     subdivision?: number;
 }
+export interface MatchForm {
+    matchId: string;
+    result: 'WIN' | 'LOSE';
+    side: 'HOME' | 'AWAY';
+    opponent: string;
+    dR: number;
+}
 export type Match = Omit<DataProps<_Match>, 'sets' | 'homeTeam' | 'awayTeam' | 'VPERs'> & {
     sets: MatchSet[];
     boxScores: BoxScore[];
@@ -37,6 +44,8 @@ export type Match = Omit<DataProps<_Match>, 'sets' | 'homeTeam' | 'awayTeam' | '
     results?: Results;
     competition?: MatchCompetition;
     rallyMetrics?: RallyMetrics;
+    homeForm?: MatchForm[];
+    awayForm?: MatchForm[];
 };
 export type RallyEvent = DataProps<_RallyEvent> & {
     team?: Team;
@@ -65,6 +74,7 @@ export interface ApiSetSubConfig {
     mode: SubMode;
     benchId?: string;
     fatigueBand?: EnergyBand;
+    benchFatigueBand?: EnergyBand;
     conditions?: PinchCondition[];
     conditionLogic?: ConditionLogic;
 }
@@ -73,6 +83,7 @@ export interface ApiDesignatedSub {
     benchId?: string;
     mode: SubMode;
     fatigueBand?: EnergyBand;
+    benchFatigueBand?: EnergyBand;
     conditions?: PinchCondition[];
     conditionLogic?: ConditionLogic;
     sets?: ApiSetSubConfig[];

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

@@ -17,6 +17,7 @@ export interface SetSubConfigAttributes {
     mode: SubMode;
     benchId?: PlayerId;
     fatigueBand?: EnergyBand;
+    benchFatigueBand?: EnergyBand;
     conditions?: PinchCondition[];
     conditionLogic?: ConditionLogic;
 }
@@ -26,6 +27,7 @@ export interface DesignatedSubAttributes {
     mode?: SubMode;
     isPinchServer?: boolean;
     fatigueBand?: SubBand;
+    benchFatigueBand?: EnergyBand;
     conditions?: PinchCondition[];
     conditionLogic?: ConditionLogic;
     sets?: SetSubConfigAttributes[];

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

@@ -62,12 +62,14 @@ function transformToAttributes(tactics, teamId) {
             benchId: ds.bench?.id,
             mode: ds.mode,
             fatigueBand: ds.fatigueBand,
+            benchFatigueBand: ds.benchFatigueBand,
             conditions: ds.conditions,
             conditionLogic: ds.conditionLogic,
             sets: ds.sets?.map(s => ({
                 mode: s.mode,
                 benchId: s.bench?.id,
                 fatigueBand: s.fatigueBand,
+                benchFatigueBand: s.benchFatigueBand,
                 conditions: s.conditions,
                 conditionLogic: s.conditionLogic
             }))
@@ -115,12 +117,14 @@ function transformToObject(model, roster) {
             bench: d.benchId != null ? findPlayer(d.benchId, roster) : undefined,
             mode: subModeFromAttributes(d),
             fatigueBand: d.fatigueBand === 'NEVER' ? undefined : d.fatigueBand,
+            benchFatigueBand: d.benchFatigueBand,
             conditions: d.conditions,
             conditionLogic: d.conditionLogic,
             sets: d.sets?.map(s => ({
                 mode: s.mode,
                 bench: s.benchId != null ? findPlayer(s.benchId, roster) : undefined,
                 fatigueBand: s.fatigueBand,
+                benchFatigueBand: s.benchFatigueBand,
                 conditions: s.conditions,
                 conditionLogic: s.conditionLogic
             }))

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

@@ -10,6 +10,7 @@ export declare const declineProfiles: DeclineProfileEnum[];
 interface DeclineProfileEntry {
     profile: string;
     startAge: number;
+    youthAge: number;
     initTicks: number;
     accel: number;
     peakTicks: number;
@@ -25,6 +26,7 @@ export declare const SKILL_POOL: PerformanceStatsKey[];
  */
 export declare const ENERGY_POOL: PerformanceStatsKey[];
 export declare function getDeclineProfile(profile: DeclineProfile): DeclineProfileEntry;
+export declare function youthMultiplier(age: number, profile: DeclineProfile): number;
 export type DeclineStatus = 'ACTIVE' | 'DECLINING' | 'PEAK';
 export interface DeclineTick {
     /** Number of decline ticks to apply this iteration. */

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

@@ -2,6 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ENERGY_POOL = exports.SKILL_POOL = exports.declineProfiles = exports.DeclineProfileEnum = void 0;
 exports.getDeclineProfile = getDeclineProfile;
+exports.youthMultiplier = youthMultiplier;
 exports.computeDeclineTick = computeDeclineTick;
 const stat_config_1 = require("../../stat-config");
 var DeclineProfileEnum;
@@ -34,6 +35,12 @@ function getDeclineProfile(profile) {
         throw new Error(`UNKNOWN_DECLINE_PROFILE: ${profile}`);
     return entry;
 }
+// Prospects below their profile's youthAge develop faster: a multiplier applied to the per-match improvement
+// experience. At or above youthAge (and pre-decline) growth is at the normal rate.
+const YOUTH_EXP_MULTIPLIER = 1.25;
+function youthMultiplier(age, profile) {
+    return age < getDeclineProfile(profile).youthAge ? YOUTH_EXP_MULTIPLIER : 1;
+}
 /**
  * Decline is fully derivable from age + profile — no running state is persisted.
  *   tickRate = min(peakTicks, initTicks + (age - startAge) * accel)

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

@@ -100,3 +100,20 @@ const performance_stats_keys_1 = require("./performance-stats-keys");
         (0, globals_1.expect)((0, decline_1.computeDeclineTick)(33, decline_1.DeclineProfileEnum.STANDARD).atPeak).toBe(true);
     });
 });
+// ─── youthMultiplier ───────────────────────────────────────────────────────────
+(0, globals_1.describe)('youthMultiplier()', () => {
+    globals_1.it.each([
+        [decline_1.DeclineProfileEnum.PRODIGY, 20],
+        [decline_1.DeclineProfileEnum.STANDARD, 21],
+        [decline_1.DeclineProfileEnum.VETERAN, 22],
+        [decline_1.DeclineProfileEnum.IRONMAN, 23]
+    ])('%s youthAge is %i', (profile, youthAge) => {
+        (0, globals_1.expect)((0, decline_1.getDeclineProfile)(profile).youthAge).toBe(youthAge);
+    });
+    (0, globals_1.it)('boosts players below youthAge by 1.25 and leaves the rest at 1', () => {
+        (0, globals_1.expect)((0, decline_1.youthMultiplier)(20, decline_1.DeclineProfileEnum.STANDARD)).toBe(1.25); // youthAge 21
+        (0, globals_1.expect)((0, decline_1.youthMultiplier)(21, decline_1.DeclineProfileEnum.STANDARD)).toBe(1);
+        (0, globals_1.expect)((0, decline_1.youthMultiplier)(19, decline_1.DeclineProfileEnum.PRODIGY)).toBe(1.25); // youthAge 20
+        (0, globals_1.expect)((0, decline_1.youthMultiplier)(20, decline_1.DeclineProfileEnum.PRODIGY)).toBe(1);
+    });
+});

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

@@ -1,8 +1,11 @@
 import { Rarity } from './rarity';
 import { Stats } from './stats';
+import { DeclineProfile } from './decline';
 export type TrainingFocus = Stats;
 export declare function getStatCap(rarity: Rarity): number;
 export declare function getRarityMultiplier(rarity: Rarity): number;
 export declare function getImprovementThreshold(statTotal: number, rarity: Rarity): number;
 export declare function getCoachMultiplier(rarity: Rarity): number;
+export declare function matchExperience(pointsPlayed: number): number;
+export declare function experienceGained(pointsPlayed: number, age: number, profile: DeclineProfile): number;
 export declare function selectImprovableStat(rarity: Rarity, trainingFocus: TrainingFocus, currentStats: Record<string, number>): string | null;

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

@@ -4,11 +4,14 @@ exports.getStatCap = getStatCap;
 exports.getRarityMultiplier = getRarityMultiplier;
 exports.getImprovementThreshold = getImprovementThreshold;
 exports.getCoachMultiplier = getCoachMultiplier;
+exports.matchExperience = matchExperience;
+exports.experienceGained = experienceGained;
 exports.selectImprovableStat = selectImprovableStat;
 const stat_config_1 = require("../../stat-config");
 const rarity_1 = require("./rarity");
 const performance_stats_1 = require("./performance-stats");
 const stats_1 = require("./stats");
+const decline_1 = require("./decline");
 const CURVE_BASE = 100;
 const CURVE_SCALAR = 0.098;
 const CURVE_EXPONENT = 1.5;
@@ -40,6 +43,26 @@ const COACH_MULTIPLIERS = {
 function getCoachMultiplier(rarity) {
     return COACH_MULTIPLIERS[rarity] ?? 1.0;
 }
+// ── Per-match experience curve ──────────────────────────────────────────────
+// Experience is no longer 1:1 with points played: each point is worth progressively less (a saturating
+// curve), so high-volume matches (5-setters, never-subbed players) don't improve disproportionately fast.
+// MATCH_EXP_K sets the long-match premium - a ~206-point 5-setter yields only ~13% more exp than a ~147-point
+// 3-setter. MATCH_EXP_SCALE is the asymptote, calibrated so exp == points at ~60 points played (the league-
+// average match): a normal match keeps roughly its old value and only longer matches are throttled. Tuning
+// MATCH_EXP_SCALE shifts overall pace without changing the premium; MATCH_EXP_K changes the premium.
+const MATCH_EXP_SCALE = 160;
+const MATCH_EXP_K = 100;
+function matchExperience(pointsPlayed) {
+    if (pointsPlayed <= 0)
+        return 0;
+    return (MATCH_EXP_SCALE * pointsPlayed) / (pointsPlayed + MATCH_EXP_K);
+}
+// Total improvement experience a player earns from a match: the saturating per-match curve, boosted for
+// players still below their decline profile's youthAge (prospects develop faster). Rounded - the progress
+// counter holds whole units.
+function experienceGained(pointsPlayed, age, profile) {
+    return Math.round(matchExperience(pointsPlayed) * (0, decline_1.youthMultiplier)(age, profile));
+}
 const KEY_TO_COLUMN = {
     setting: 'setting',
     serve: 'serve',

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

@@ -4,6 +4,7 @@ const globals_1 = require("@jest/globals");
 const rarity_1 = require("./rarity");
 const improvement_1 = require("./improvement");
 const stats_1 = require("./stats");
+const decline_1 = require("./decline");
 // ─── getStatCap ───────────────────────────────────────────────────────────────
 (0, globals_1.describe)('getStatCap()', () => {
     globals_1.it.each([
@@ -142,3 +143,38 @@ function allStats(value) {
         }
     });
 });
+// ─── matchExperience / experienceGained ───────────────────────────────────────
+(0, globals_1.describe)('matchExperience()', () => {
+    (0, globals_1.it)('breaks even (~1:1) at the league-average match (~60 points)', () => {
+        (0, globals_1.expect)((0, improvement_1.matchExperience)(60)).toBeCloseTo(60, 0);
+    });
+    (0, globals_1.it)('throttles high-volume matches well below their raw points', () => {
+        (0, globals_1.expect)((0, improvement_1.matchExperience)(206)).toBeLessThan(206);
+        (0, globals_1.expect)((0, improvement_1.matchExperience)(206)).toBeCloseTo(108, 0);
+    });
+    (0, globals_1.it)('gives a 5-set match (~206 pts) only ~13% more than a 3-set match (~147 pts)', () => {
+        (0, globals_1.expect)((0, improvement_1.matchExperience)(206) / (0, improvement_1.matchExperience)(147)).toBeCloseTo(1.13, 2);
+    });
+    (0, globals_1.it)('is monotonic non-decreasing in points played', () => {
+        let prev = -1;
+        for (let p = 0; p <= 250; p += 10) {
+            const v = (0, improvement_1.matchExperience)(p);
+            (0, globals_1.expect)(v).toBeGreaterThanOrEqual(prev);
+            prev = v;
+        }
+    });
+    (0, globals_1.it)('zero or negative points → zero exp', () => {
+        (0, globals_1.expect)((0, improvement_1.matchExperience)(0)).toBe(0);
+        (0, globals_1.expect)((0, improvement_1.matchExperience)(-5)).toBe(0);
+    });
+});
+(0, globals_1.describe)('experienceGained()', () => {
+    (0, globals_1.it)('young players (below their profile youthAge) gain 25% more than the base', () => {
+        const base = Math.round((0, improvement_1.matchExperience)(100));
+        (0, globals_1.expect)((0, improvement_1.experienceGained)(100, 18, decline_1.DeclineProfileEnum.STANDARD)).toBe(Math.round((0, improvement_1.matchExperience)(100) * 1.25));
+        (0, globals_1.expect)((0, improvement_1.experienceGained)(100, 25, decline_1.DeclineProfileEnum.STANDARD)).toBe(base);
+    });
+    (0, globals_1.it)('zero points → zero exp regardless of age', () => {
+        (0, globals_1.expect)((0, improvement_1.experienceGained)(0, 18, decline_1.DeclineProfileEnum.STANDARD)).toBe(0);
+    });
+});

package/dist/cjs/src/service/team/designated-sub.d.ts

@@ -5,6 +5,7 @@ export interface SetSubConfig {
     readonly mode: SubMode;
     readonly bench?: Player;
     readonly fatigueBand?: EnergyBand;
+    readonly benchFatigueBand?: EnergyBand;
     readonly conditions?: PinchCondition[];
     readonly conditionLogic?: ConditionLogic;
 }

package/dist/cjs/src/service/team/schemas/designated-sub.z.d.ts

@@ -43,6 +43,7 @@ export declare const SetSubConfigSchema: z.ZodObject<{
     }>;
     bench: z.ZodOptional<z.ZodCustom<Player, Player>>;
     fatigueBand: z.ZodOptional<z.ZodEnum<typeof EnergyBand>>;
+    benchFatigueBand: z.ZodOptional<z.ZodEnum<typeof EnergyBand>>;
     conditions: z.ZodOptional<z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
         type: z.ZodLiteral<PinchConditionType.ASAP>;
     }, z.core.$strip>, z.ZodObject<{
@@ -80,6 +81,7 @@ export declare const DesignatedSubSchema: z.ZodObject<{
         }>;
         bench: z.ZodOptional<z.ZodCustom<Player, Player>>;
         fatigueBand: z.ZodOptional<z.ZodEnum<typeof EnergyBand>>;
+        benchFatigueBand: z.ZodOptional<z.ZodEnum<typeof EnergyBand>>;
         conditions: z.ZodOptional<z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
             type: z.ZodLiteral<PinchConditionType.ASAP>;
         }, z.core.$strip>, z.ZodObject<{
@@ -115,6 +117,7 @@ export declare const DesignatedSubSchema: z.ZodObject<{
     }>;
     bench: z.ZodOptional<z.ZodCustom<Player, Player>>;
     fatigueBand: z.ZodOptional<z.ZodEnum<typeof EnergyBand>>;
+    benchFatigueBand: z.ZodOptional<z.ZodEnum<typeof EnergyBand>>;
     conditions: z.ZodOptional<z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
         type: z.ZodLiteral<PinchConditionType.ASAP>;
     }, z.core.$strip>, z.ZodObject<{

package/dist/cjs/src/service/team/schemas/designated-sub.z.js

@@ -26,6 +26,7 @@ const setSubConfigShape = {
     mode: exports.SubModeSchema,
     bench: playerInstanceSchema.optional(),
     fatigueBand: zod_1.z.nativeEnum(energy_band_1.EnergyBand).optional(),
+    benchFatigueBand: zod_1.z.nativeEnum(energy_band_1.EnergyBand).optional(),
     conditions: zod_1.z.array(exports.PinchConditionSchema).optional(),
     conditionLogic: exports.ConditionLogicSchema.optional()
 };

package/dist/cjs/src/service/team/schemas/tactics.z.d.ts

@@ -26,6 +26,7 @@ export declare const TacticsInputSchema: z.ZodObject<{
             }>;
             bench: z.ZodOptional<z.ZodCustom<Player, Player>>;
             fatigueBand: z.ZodOptional<z.ZodEnum<typeof EnergyBand>>;
+            benchFatigueBand: z.ZodOptional<z.ZodEnum<typeof EnergyBand>>;
             conditions: z.ZodOptional<z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
                 type: z.ZodLiteral<import("..").PinchConditionType.ASAP>;
             }, z.core.$strip>, z.ZodObject<{
@@ -61,6 +62,7 @@ export declare const TacticsInputSchema: z.ZodObject<{
         }>;
         bench: z.ZodOptional<z.ZodCustom<Player, Player>>;
         fatigueBand: z.ZodOptional<z.ZodEnum<typeof EnergyBand>>;
+        benchFatigueBand: z.ZodOptional<z.ZodEnum<typeof EnergyBand>>;
         conditions: z.ZodOptional<z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
             type: z.ZodLiteral<import("..").PinchConditionType.ASAP>;
         }, z.core.$strip>, z.ZodObject<{

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

@@ -34,6 +34,7 @@ export declare const TeamInputSchema: z.ZodObject<{
                 }>;
                 bench: z.ZodOptional<z.ZodCustom<Player, Player>>;
                 fatigueBand: z.ZodOptional<z.ZodEnum<typeof import("..").EnergyBand>>;
+                benchFatigueBand: z.ZodOptional<z.ZodEnum<typeof import("..").EnergyBand>>;
                 conditions: z.ZodOptional<z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
                     type: z.ZodLiteral<import("..").PinchConditionType.ASAP>;
                 }, z.core.$strip>, z.ZodObject<{
@@ -69,6 +70,7 @@ export declare const TeamInputSchema: z.ZodObject<{
             }>;
             bench: z.ZodOptional<z.ZodCustom<Player, Player>>;
             fatigueBand: z.ZodOptional<z.ZodEnum<typeof import("..").EnergyBand>>;
+            benchFatigueBand: z.ZodOptional<z.ZodEnum<typeof import("..").EnergyBand>>;
             conditions: z.ZodOptional<z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
                 type: z.ZodLiteral<import("..").PinchConditionType.ASAP>;
             }, z.core.$strip>, z.ZodObject<{

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

@@ -1,6 +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 }
+    { "profile": "PRODIGY", "startAge": 27, "youthAge": 20, "initTicks": 13.0, "accel": 1.00, "peakTicks": 16.0 },
+    { "profile": "STANDARD", "startAge": 29, "youthAge": 21, "initTicks": 9.0, "accel": 1.75, "peakTicks": 16.0 },
+    { "profile": "VETERAN", "startAge": 32, "youthAge": 22, "initTicks": 10.0, "accel": 1.50, "peakTicks": 16.0 },
+    { "profile": "IRONMAN", "startAge": 34, "youthAge": 23, "initTicks": 10.0, "accel": 1.50, "peakTicks": 16.0 }
 ]

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

@@ -24,6 +24,13 @@ export interface MatchCompetition {
     tier?: number;
     subdivision?: number;
 }
+export interface MatchForm {
+    matchId: string;
+    result: 'WIN' | 'LOSE';
+    side: 'HOME' | 'AWAY';
+    opponent: string;
+    dR: number;
+}
 export type Match = Omit<DataProps<_Match>, 'sets' | 'homeTeam' | 'awayTeam' | 'VPERs'> & {
     sets: MatchSet[];
     boxScores: BoxScore[];
@@ -37,6 +44,8 @@ export type Match = Omit<DataProps<_Match>, 'sets' | 'homeTeam' | 'awayTeam' | '
     results?: Results;
     competition?: MatchCompetition;
     rallyMetrics?: RallyMetrics;
+    homeForm?: MatchForm[];
+    awayForm?: MatchForm[];
 };
 export type RallyEvent = DataProps<_RallyEvent> & {
     team?: Team;
@@ -65,6 +74,7 @@ export interface ApiSetSubConfig {
     mode: SubMode;
     benchId?: string;
     fatigueBand?: EnergyBand;
+    benchFatigueBand?: EnergyBand;
     conditions?: PinchCondition[];
     conditionLogic?: ConditionLogic;
 }
@@ -73,6 +83,7 @@ export interface ApiDesignatedSub {
     benchId?: string;
     mode: SubMode;
     fatigueBand?: EnergyBand;
+    benchFatigueBand?: EnergyBand;
     conditions?: PinchCondition[];
     conditionLogic?: ConditionLogic;
     sets?: ApiSetSubConfig[];

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

@@ -17,6 +17,7 @@ export interface SetSubConfigAttributes {
     mode: SubMode;
     benchId?: PlayerId;
     fatigueBand?: EnergyBand;
+    benchFatigueBand?: EnergyBand;
     conditions?: PinchCondition[];
     conditionLogic?: ConditionLogic;
 }
@@ -26,6 +27,7 @@ export interface DesignatedSubAttributes {
     mode?: SubMode;
     isPinchServer?: boolean;
     fatigueBand?: SubBand;
+    benchFatigueBand?: EnergyBand;
     conditions?: PinchCondition[];
     conditionLogic?: ConditionLogic;
     sets?: SetSubConfigAttributes[];

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

@@ -58,12 +58,14 @@ function transformToAttributes(tactics, teamId) {
             benchId: ds.bench?.id,
             mode: ds.mode,
             fatigueBand: ds.fatigueBand,
+            benchFatigueBand: ds.benchFatigueBand,
             conditions: ds.conditions,
             conditionLogic: ds.conditionLogic,
             sets: ds.sets?.map(s => ({
                 mode: s.mode,
                 benchId: s.bench?.id,
                 fatigueBand: s.fatigueBand,
+                benchFatigueBand: s.benchFatigueBand,
                 conditions: s.conditions,
                 conditionLogic: s.conditionLogic
             }))
@@ -111,12 +113,14 @@ function transformToObject(model, roster) {
             bench: d.benchId != null ? findPlayer(d.benchId, roster) : undefined,
             mode: subModeFromAttributes(d),
             fatigueBand: d.fatigueBand === 'NEVER' ? undefined : d.fatigueBand,
+            benchFatigueBand: d.benchFatigueBand,
             conditions: d.conditions,
             conditionLogic: d.conditionLogic,
             sets: d.sets?.map(s => ({
                 mode: s.mode,
                 bench: s.benchId != null ? findPlayer(s.benchId, roster) : undefined,
                 fatigueBand: s.fatigueBand,
+                benchFatigueBand: s.benchFatigueBand,
                 conditions: s.conditions,
                 conditionLogic: s.conditionLogic
             }))

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

@@ -10,6 +10,7 @@ export declare const declineProfiles: DeclineProfileEnum[];
 interface DeclineProfileEntry {
     profile: string;
     startAge: number;
+    youthAge: number;
     initTicks: number;
     accel: number;
     peakTicks: number;
@@ -25,6 +26,7 @@ export declare const SKILL_POOL: PerformanceStatsKey[];
  */
 export declare const ENERGY_POOL: PerformanceStatsKey[];
 export declare function getDeclineProfile(profile: DeclineProfile): DeclineProfileEntry;
+export declare function youthMultiplier(age: number, profile: DeclineProfile): number;
 export type DeclineStatus = 'ACTIVE' | 'DECLINING' | 'PEAK';
 export interface DeclineTick {
     /** Number of decline ticks to apply this iteration. */

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

@@ -29,6 +29,12 @@ export function getDeclineProfile(profile) {
         throw new Error(`UNKNOWN_DECLINE_PROFILE: ${profile}`);
     return entry;
 }
+// Prospects below their profile's youthAge develop faster: a multiplier applied to the per-match improvement
+// experience. At or above youthAge (and pre-decline) growth is at the normal rate.
+const YOUTH_EXP_MULTIPLIER = 1.25;
+export function youthMultiplier(age, profile) {
+    return age < getDeclineProfile(profile).youthAge ? YOUTH_EXP_MULTIPLIER : 1;
+}
 /**
  * Decline is fully derivable from age + profile — no running state is persisted.
  *   tickRate = min(peakTicks, initTicks + (age - startAge) * accel)

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

@@ -1,5 +1,5 @@
 import { describe, it, expect } from '@jest/globals';
-import { DeclineProfileEnum, declineProfiles, getDeclineProfile, computeDeclineTick, SKILL_POOL, ENERGY_POOL } from './decline';
+import { DeclineProfileEnum, declineProfiles, getDeclineProfile, computeDeclineTick, youthMultiplier, SKILL_POOL, ENERGY_POOL } from './decline';
 import { performanceStatKeys } from './performance-stats-keys';
 // ─── getDeclineProfile ─────────────────────────────────────────────────────────
 describe('getDeclineProfile()', () => {
@@ -98,3 +98,20 @@ describe('computeDeclineTick()', () => {
         expect(computeDeclineTick(33, DeclineProfileEnum.STANDARD).atPeak).toBe(true);
     });
 });
+// ─── youthMultiplier ───────────────────────────────────────────────────────────
+describe('youthMultiplier()', () => {
+    it.each([
+        [DeclineProfileEnum.PRODIGY, 20],
+        [DeclineProfileEnum.STANDARD, 21],
+        [DeclineProfileEnum.VETERAN, 22],
+        [DeclineProfileEnum.IRONMAN, 23]
+    ])('%s youthAge is %i', (profile, youthAge) => {
+        expect(getDeclineProfile(profile).youthAge).toBe(youthAge);
+    });
+    it('boosts players below youthAge by 1.25 and leaves the rest at 1', () => {
+        expect(youthMultiplier(20, DeclineProfileEnum.STANDARD)).toBe(1.25); // youthAge 21
+        expect(youthMultiplier(21, DeclineProfileEnum.STANDARD)).toBe(1);
+        expect(youthMultiplier(19, DeclineProfileEnum.PRODIGY)).toBe(1.25); // youthAge 20
+        expect(youthMultiplier(20, DeclineProfileEnum.PRODIGY)).toBe(1);
+    });
+});

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

@@ -1,8 +1,11 @@
 import { Rarity } from './rarity';
 import { Stats } from './stats';
+import { DeclineProfile } from './decline';
 export type TrainingFocus = Stats;
 export declare function getStatCap(rarity: Rarity): number;
 export declare function getRarityMultiplier(rarity: Rarity): number;
 export declare function getImprovementThreshold(statTotal: number, rarity: Rarity): number;
 export declare function getCoachMultiplier(rarity: Rarity): number;
+export declare function matchExperience(pointsPlayed: number): number;
+export declare function experienceGained(pointsPlayed: number, age: number, profile: DeclineProfile): number;
 export declare function selectImprovableStat(rarity: Rarity, trainingFocus: TrainingFocus, currentStats: Record<string, number>): string | null;

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

@@ -2,6 +2,7 @@ import { statCapsJSON } from '../../stat-config';
 import { RarityEnum } from './rarity';
 import { performanceStatKeys } from './performance-stats';
 import { getMultipliers } from './stats';
+import { youthMultiplier } from './decline';
 const CURVE_BASE = 100;
 const CURVE_SCALAR = 0.098;
 const CURVE_EXPONENT = 1.5;
@@ -33,6 +34,26 @@ const COACH_MULTIPLIERS = {
 export function getCoachMultiplier(rarity) {
     return COACH_MULTIPLIERS[rarity] ?? 1.0;
 }
+// ── Per-match experience curve ──────────────────────────────────────────────
+// Experience is no longer 1:1 with points played: each point is worth progressively less (a saturating
+// curve), so high-volume matches (5-setters, never-subbed players) don't improve disproportionately fast.
+// MATCH_EXP_K sets the long-match premium - a ~206-point 5-setter yields only ~13% more exp than a ~147-point
+// 3-setter. MATCH_EXP_SCALE is the asymptote, calibrated so exp == points at ~60 points played (the league-
+// average match): a normal match keeps roughly its old value and only longer matches are throttled. Tuning
+// MATCH_EXP_SCALE shifts overall pace without changing the premium; MATCH_EXP_K changes the premium.
+const MATCH_EXP_SCALE = 160;
+const MATCH_EXP_K = 100;
+export function matchExperience(pointsPlayed) {
+    if (pointsPlayed <= 0)
+        return 0;
+    return (MATCH_EXP_SCALE * pointsPlayed) / (pointsPlayed + MATCH_EXP_K);
+}
+// Total improvement experience a player earns from a match: the saturating per-match curve, boosted for
+// players still below their decline profile's youthAge (prospects develop faster). Rounded - the progress
+// counter holds whole units.
+export function experienceGained(pointsPlayed, age, profile) {
+    return Math.round(matchExperience(pointsPlayed) * youthMultiplier(age, profile));
+}
 const KEY_TO_COLUMN = {
     setting: 'setting',
     serve: 'serve',

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

@@ -1,7 +1,8 @@
 import { describe, it, expect } from '@jest/globals';
 import { RarityEnum } from './rarity';
-import { getStatCap, getRarityMultiplier, getImprovementThreshold, getCoachMultiplier, selectImprovableStat } from './improvement';
+import { getStatCap, getRarityMultiplier, getImprovementThreshold, getCoachMultiplier, selectImprovableStat, matchExperience, experienceGained } from './improvement';
 import { StatsEnum } from './stats';
+import { DeclineProfileEnum } from './decline';
 // ─── getStatCap ───────────────────────────────────────────────────────────────
 describe('getStatCap()', () => {
     it.each([
@@ -140,3 +141,38 @@ describe('selectImprovableStat()', () => {
         }
     });
 });
+// ─── matchExperience / experienceGained ───────────────────────────────────────
+describe('matchExperience()', () => {
+    it('breaks even (~1:1) at the league-average match (~60 points)', () => {
+        expect(matchExperience(60)).toBeCloseTo(60, 0);
+    });
+    it('throttles high-volume matches well below their raw points', () => {
+        expect(matchExperience(206)).toBeLessThan(206);
+        expect(matchExperience(206)).toBeCloseTo(108, 0);
+    });
+    it('gives a 5-set match (~206 pts) only ~13% more than a 3-set match (~147 pts)', () => {
+        expect(matchExperience(206) / matchExperience(147)).toBeCloseTo(1.13, 2);
+    });
+    it('is monotonic non-decreasing in points played', () => {
+        let prev = -1;
+        for (let p = 0; p <= 250; p += 10) {
+            const v = matchExperience(p);
+            expect(v).toBeGreaterThanOrEqual(prev);
+            prev = v;
+        }
+    });
+    it('zero or negative points → zero exp', () => {
+        expect(matchExperience(0)).toBe(0);
+        expect(matchExperience(-5)).toBe(0);
+    });
+});
+describe('experienceGained()', () => {
+    it('young players (below their profile youthAge) gain 25% more than the base', () => {
+        const base = Math.round(matchExperience(100));
+        expect(experienceGained(100, 18, DeclineProfileEnum.STANDARD)).toBe(Math.round(matchExperience(100) * 1.25));
+        expect(experienceGained(100, 25, DeclineProfileEnum.STANDARD)).toBe(base);
+    });
+    it('zero points → zero exp regardless of age', () => {
+        expect(experienceGained(0, 18, DeclineProfileEnum.STANDARD)).toBe(0);
+    });
+});

package/dist/esm/src/service/team/designated-sub.d.ts

@@ -5,6 +5,7 @@ export interface SetSubConfig {
     readonly mode: SubMode;
     readonly bench?: Player;
     readonly fatigueBand?: EnergyBand;
+    readonly benchFatigueBand?: EnergyBand;
     readonly conditions?: PinchCondition[];
     readonly conditionLogic?: ConditionLogic;
 }

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

@@ -43,6 +43,7 @@ export declare const SetSubConfigSchema: z.ZodObject<{
     }>;
     bench: z.ZodOptional<z.ZodCustom<Player, Player>>;
     fatigueBand: z.ZodOptional<z.ZodEnum<typeof EnergyBand>>;
+    benchFatigueBand: z.ZodOptional<z.ZodEnum<typeof EnergyBand>>;
     conditions: z.ZodOptional<z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
         type: z.ZodLiteral<PinchConditionType.ASAP>;
     }, z.core.$strip>, z.ZodObject<{
@@ -80,6 +81,7 @@ export declare const DesignatedSubSchema: z.ZodObject<{
         }>;
         bench: z.ZodOptional<z.ZodCustom<Player, Player>>;
         fatigueBand: z.ZodOptional<z.ZodEnum<typeof EnergyBand>>;
+        benchFatigueBand: z.ZodOptional<z.ZodEnum<typeof EnergyBand>>;
         conditions: z.ZodOptional<z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
             type: z.ZodLiteral<PinchConditionType.ASAP>;
         }, z.core.$strip>, z.ZodObject<{
@@ -115,6 +117,7 @@ export declare const DesignatedSubSchema: z.ZodObject<{
     }>;
     bench: z.ZodOptional<z.ZodCustom<Player, Player>>;
     fatigueBand: z.ZodOptional<z.ZodEnum<typeof EnergyBand>>;
+    benchFatigueBand: z.ZodOptional<z.ZodEnum<typeof EnergyBand>>;
     conditions: z.ZodOptional<z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
         type: z.ZodLiteral<PinchConditionType.ASAP>;
     }, z.core.$strip>, z.ZodObject<{

package/dist/esm/src/service/team/schemas/designated-sub.z.js

@@ -23,6 +23,7 @@ const setSubConfigShape = {
     mode: SubModeSchema,
     bench: playerInstanceSchema.optional(),
     fatigueBand: z.nativeEnum(EnergyBand).optional(),
+    benchFatigueBand: z.nativeEnum(EnergyBand).optional(),
     conditions: z.array(PinchConditionSchema).optional(),
     conditionLogic: ConditionLogicSchema.optional()
 };

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

@@ -26,6 +26,7 @@ export declare const TacticsInputSchema: z.ZodObject<{
             }>;
             bench: z.ZodOptional<z.ZodCustom<Player, Player>>;
             fatigueBand: z.ZodOptional<z.ZodEnum<typeof EnergyBand>>;
+            benchFatigueBand: z.ZodOptional<z.ZodEnum<typeof EnergyBand>>;
             conditions: z.ZodOptional<z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
                 type: z.ZodLiteral<import("..").PinchConditionType.ASAP>;
             }, z.core.$strip>, z.ZodObject<{
@@ -61,6 +62,7 @@ export declare const TacticsInputSchema: z.ZodObject<{
         }>;
         bench: z.ZodOptional<z.ZodCustom<Player, Player>>;
         fatigueBand: z.ZodOptional<z.ZodEnum<typeof EnergyBand>>;
+        benchFatigueBand: z.ZodOptional<z.ZodEnum<typeof EnergyBand>>;
         conditions: z.ZodOptional<z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
             type: z.ZodLiteral<import("..").PinchConditionType.ASAP>;
         }, z.core.$strip>, z.ZodObject<{

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

@@ -34,6 +34,7 @@ export declare const TeamInputSchema: z.ZodObject<{
                 }>;
                 bench: z.ZodOptional<z.ZodCustom<Player, Player>>;
                 fatigueBand: z.ZodOptional<z.ZodEnum<typeof import("..").EnergyBand>>;
+                benchFatigueBand: z.ZodOptional<z.ZodEnum<typeof import("..").EnergyBand>>;
                 conditions: z.ZodOptional<z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
                     type: z.ZodLiteral<import("..").PinchConditionType.ASAP>;
                 }, z.core.$strip>, z.ZodObject<{
@@ -69,6 +70,7 @@ export declare const TeamInputSchema: z.ZodObject<{
             }>;
             bench: z.ZodOptional<z.ZodCustom<Player, Player>>;
             fatigueBand: z.ZodOptional<z.ZodEnum<typeof import("..").EnergyBand>>;
+            benchFatigueBand: z.ZodOptional<z.ZodEnum<typeof import("..").EnergyBand>>;
             conditions: z.ZodOptional<z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
                 type: z.ZodLiteral<import("..").PinchConditionType.ASAP>;
             }, z.core.$strip>, z.ZodObject<{

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

@@ -1,6 +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 }
+    { "profile": "PRODIGY", "startAge": 27, "youthAge": 20, "initTicks": 13.0, "accel": 1.00, "peakTicks": 16.0 },
+    { "profile": "STANDARD", "startAge": 29, "youthAge": 21, "initTicks": 9.0, "accel": 1.75, "peakTicks": 16.0 },
+    { "profile": "VETERAN", "startAge": 32, "youthAge": 22, "initTicks": 10.0, "accel": 1.50, "peakTicks": 16.0 },
+    { "profile": "IRONMAN", "startAge": 34, "youthAge": 23, "initTicks": 10.0, "accel": 1.50, "peakTicks": 16.0 }
 ]

package/package.json

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