volleyballsimtypes 0.0.424 → 0.0.426

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;

package/dist/cjs/src/service/match/rally-metrics.d.ts

@@ -16,7 +16,9 @@ export interface RallyMetricsSet {
 export interface RotationMetrics {
     setterZone: number | null;
     rotation: number;
+    serves: number;
     servePoints: number;
+    receptions: number;
     sideoutPoints: number;
     points: number;
 }

package/dist/cjs/src/service/match/rally-metrics.js

@@ -26,17 +26,16 @@ function setterZoneAt(startZone, rotationIndex) {
         zone = (0, court_position_1.rotatePosition)(zone);
     return zone;
 }
-function addRotationPoint(acc, setterZone, rotation, kind) {
+// Get (or create) a team's rotation bucket, keyed by setter zone when known (so the total sums by zone
+// across sets), else by the rotation index.
+function rotationEntry(acc, setterZone, rotation) {
     const key = setterZone != null ? `z${setterZone}` : `r${rotation}`;
     let entry = acc.rotations.get(key);
     if (entry == null) {
-        entry = { setterZone, rotation, servePoints: 0, sideoutPoints: 0 };
+        entry = { setterZone, rotation, servePoints: 0, sideoutPoints: 0, serves: 0, receptions: 0 };
         acc.rotations.set(key, entry);
     }
-    if (kind === 'serve')
-        entry.servePoints++;
-    else
-        entry.sideoutPoints++;
+    return entry;
 }
 // Walk one set, folding its rallies into the home/away accumulators (used for both per-set and total).
 function accumulateSet(set, homeId, awayId, homeAcc, awayAcc) {
@@ -53,24 +52,27 @@ function accumulateSet(set, homeId, awayId, homeAcc, awayAcc) {
         const winnerId = i < rallies.length - 1 ? rallies[i + 1].servingTeamId : setWinnerId;
         const serving = accOf(servingId);
         const receiving = accOf(receivingId);
-        const winner = accOf(winnerId);
-        if (serving == null || receiving == null || winner == null)
+        if (serving == null || receiving == null || (winnerId !== servingId && winnerId !== receivingId))
             continue;
         serving.serves++;
         receiving.receptions++;
         if (isServiceError(rallies[i]))
             receiving.serviceErrorsReceived++;
-        const rotIdx = rotation[winnerId];
-        const zone = setterZoneAt(startZone[winnerId], rotIdx);
+        // Per-rotation attempts: both teams play this rally in their current rotation. The point below is
+        // attributed to the winner, whose bucket is the same serve (breakpoint) or reception (sideout) entry.
+        const serveEntry = rotationEntry(serving, setterZoneAt(startZone[servingId], rotation[servingId]), rotation[servingId]);
+        const recEntry = rotationEntry(receiving, setterZoneAt(startZone[receivingId], rotation[receivingId]), rotation[receivingId]);
+        serveEntry.serves++;
+        recEntry.receptions++;
         if (winnerId === servingId) {
             serving.breakpointWins++;
-            addRotationPoint(winner, zone, rotIdx, 'serve');
+            serveEntry.servePoints++;
         }
         else {
             receiving.sideoutWins++;
             if (spikeCount(rallies[i]) === 1)
                 receiving.fbsoWins++;
-            addRotationPoint(winner, zone, rotIdx, 'sideout');
+            recEntry.sideoutPoints++;
         }
         // The sideout winner gains serve, so they rotate (after the point is attributed to their old rotation).
         if (winnerId === receivingId)

package/dist/cjs/src/service/match/rally-metrics.test.js

@@ -48,12 +48,12 @@ describe('computeRallyMetrics()', () => {
     it('per-set rotations labeled by setter zone, split serve vs sideout', () => {
         expect(m.sets).toHaveLength(1);
         expect(m.sets[0].home.rotations).toEqual([
-            { setterZone: 1, rotation: 2, servePoints: 1, sideoutPoints: 0, points: 1 },
-            { setterZone: 2, rotation: 1, servePoints: 1, sideoutPoints: 1, points: 2 }
+            { setterZone: 1, rotation: 2, serves: 1, servePoints: 1, receptions: 0, sideoutPoints: 0, points: 1 },
+            { setterZone: 2, rotation: 1, serves: 2, servePoints: 1, receptions: 2, sideoutPoints: 1, points: 2 }
         ]);
         expect(m.sets[0].away.rotations).toEqual([
-            { setterZone: 1, rotation: 1, servePoints: 0, sideoutPoints: 1, points: 1 },
-            { setterZone: 6, rotation: 2, servePoints: 1, sideoutPoints: 0, points: 1 }
+            { setterZone: 1, rotation: 1, serves: 0, servePoints: 0, receptions: 2, sideoutPoints: 1, points: 1 },
+            { setterZone: 6, rotation: 2, serves: 2, servePoints: 1, receptions: 1, sideoutPoints: 0, points: 1 }
         ]);
     });
 });

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/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;

package/dist/esm/src/service/match/rally-metrics.d.ts

@@ -16,7 +16,9 @@ export interface RallyMetricsSet {
 export interface RotationMetrics {
     setterZone: number | null;
     rotation: number;
+    serves: number;
     servePoints: number;
+    receptions: number;
     sideoutPoints: number;
     points: number;
 }

package/dist/esm/src/service/match/rally-metrics.js

@@ -23,17 +23,16 @@ function setterZoneAt(startZone, rotationIndex) {
         zone = rotatePosition(zone);
     return zone;
 }
-function addRotationPoint(acc, setterZone, rotation, kind) {
+// Get (or create) a team's rotation bucket, keyed by setter zone when known (so the total sums by zone
+// across sets), else by the rotation index.
+function rotationEntry(acc, setterZone, rotation) {
     const key = setterZone != null ? `z${setterZone}` : `r${rotation}`;
     let entry = acc.rotations.get(key);
     if (entry == null) {
-        entry = { setterZone, rotation, servePoints: 0, sideoutPoints: 0 };
+        entry = { setterZone, rotation, servePoints: 0, sideoutPoints: 0, serves: 0, receptions: 0 };
         acc.rotations.set(key, entry);
     }
-    if (kind === 'serve')
-        entry.servePoints++;
-    else
-        entry.sideoutPoints++;
+    return entry;
 }
 // Walk one set, folding its rallies into the home/away accumulators (used for both per-set and total).
 function accumulateSet(set, homeId, awayId, homeAcc, awayAcc) {
@@ -50,24 +49,27 @@ function accumulateSet(set, homeId, awayId, homeAcc, awayAcc) {
         const winnerId = i < rallies.length - 1 ? rallies[i + 1].servingTeamId : setWinnerId;
         const serving = accOf(servingId);
         const receiving = accOf(receivingId);
-        const winner = accOf(winnerId);
-        if (serving == null || receiving == null || winner == null)
+        if (serving == null || receiving == null || (winnerId !== servingId && winnerId !== receivingId))
             continue;
         serving.serves++;
         receiving.receptions++;
         if (isServiceError(rallies[i]))
             receiving.serviceErrorsReceived++;
-        const rotIdx = rotation[winnerId];
-        const zone = setterZoneAt(startZone[winnerId], rotIdx);
+        // Per-rotation attempts: both teams play this rally in their current rotation. The point below is
+        // attributed to the winner, whose bucket is the same serve (breakpoint) or reception (sideout) entry.
+        const serveEntry = rotationEntry(serving, setterZoneAt(startZone[servingId], rotation[servingId]), rotation[servingId]);
+        const recEntry = rotationEntry(receiving, setterZoneAt(startZone[receivingId], rotation[receivingId]), rotation[receivingId]);
+        serveEntry.serves++;
+        recEntry.receptions++;
         if (winnerId === servingId) {
             serving.breakpointWins++;
-            addRotationPoint(winner, zone, rotIdx, 'serve');
+            serveEntry.servePoints++;
         }
         else {
             receiving.sideoutWins++;
             if (spikeCount(rallies[i]) === 1)
                 receiving.fbsoWins++;
-            addRotationPoint(winner, zone, rotIdx, 'sideout');
+            recEntry.sideoutPoints++;
         }
         // The sideout winner gains serve, so they rotate (after the point is attributed to their old rotation).
         if (winnerId === receivingId)

package/dist/esm/src/service/match/rally-metrics.test.js

@@ -46,12 +46,12 @@ describe('computeRallyMetrics()', () => {
     it('per-set rotations labeled by setter zone, split serve vs sideout', () => {
         expect(m.sets).toHaveLength(1);
         expect(m.sets[0].home.rotations).toEqual([
-            { setterZone: 1, rotation: 2, servePoints: 1, sideoutPoints: 0, points: 1 },
-            { setterZone: 2, rotation: 1, servePoints: 1, sideoutPoints: 1, points: 2 }
+            { setterZone: 1, rotation: 2, serves: 1, servePoints: 1, receptions: 0, sideoutPoints: 0, points: 1 },
+            { setterZone: 2, rotation: 1, serves: 2, servePoints: 1, receptions: 2, sideoutPoints: 1, points: 2 }
         ]);
         expect(m.sets[0].away.rotations).toEqual([
-            { setterZone: 1, rotation: 1, servePoints: 0, sideoutPoints: 1, points: 1 },
-            { setterZone: 6, rotation: 2, servePoints: 1, sideoutPoints: 0, points: 1 }
+            { setterZone: 1, rotation: 1, serves: 0, servePoints: 0, receptions: 2, sideoutPoints: 1, points: 1 },
+            { setterZone: 6, rotation: 2, serves: 2, servePoints: 1, receptions: 1, sideoutPoints: 0, points: 1 }
         ]);
     });
 });

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/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.424",
+  "version": "0.0.426",
   "description": "vbsim types",
   "main": "./dist/cjs/src/index.js",
   "module": "./dist/esm/src/index.js",