volleyballsimtypes 0.0.493 → 0.0.495

package/dist/esm/src/stat-config/improvement-floors.json

@@ -0,0 +1,394 @@
+{
+    "_comment": "GENERATED FILE, do not hand-edit. Regenerate with: yarn build && yarn floors",
+    "samplesPerRarity": 400000,
+    "inputs": {
+        "wishlistAdoption": 0.3733,
+        "wishlistProcRate": 0.4,
+        "rolePickWeights": {
+            "OUTSIDE_HITTER": 0.269,
+            "MIDDLE_BLOCKER": 0.235,
+            "OPPOSITE_HITTER": 0.188,
+            "LIBERO": 0.171,
+            "SETTER": 0.137
+        },
+        "measuredFrom": "prod read-only 2026-07-24: 434 Wishlist rows, 162 with roles; role listing shares"
+    },
+    "sourceHash": "ec4620ca048d05741b9c42ce6f24a4e7bd04f047c5a420bb93f5a5e711d7adeb",
+    "floors": [
+        {
+            "rarity": "COMMON",
+            "role": "SETTER",
+            "samples": 104658,
+            "roleBranchShare": 0,
+            "all": 540.2,
+            "focus": {
+                "ATTACK": 172.3,
+                "SET": 136.7,
+                "RECEIVE": 172.6,
+                "SERVE": 93.9,
+                "BLOCK": 175.8,
+                "STAMINA": 28.6
+            }
+        },
+        {
+            "rarity": "COMMON",
+            "role": "OUTSIDE_HITTER",
+            "samples": 1886,
+            "roleBranchShare": 0,
+            "all": 545.7,
+            "focus": {
+                "ATTACK": 183.8,
+                "SET": 100,
+                "RECEIVE": 183.7,
+                "SERVE": 102.4,
+                "BLOCK": 181.6,
+                "STAMINA": 32.7
+            }
+        },
+        {
+            "rarity": "COMMON",
+            "role": "MIDDLE_BLOCKER",
+            "samples": 99825,
+            "roleBranchShare": 0,
+            "all": 541,
+            "focus": {
+                "ATTACK": 177.9,
+                "SET": 113,
+                "RECEIVE": 174.5,
+                "SERVE": 86.9,
+                "BLOCK": 198.3,
+                "STAMINA": 30.4
+            }
+        },
+        {
+            "rarity": "COMMON",
+            "role": "OPPOSITE_HITTER",
+            "samples": 85837,
+            "roleBranchShare": 0,
+            "all": 537,
+            "focus": {
+                "ATTACK": 200.9,
+                "SET": 112,
+                "RECEIVE": 172.9,
+                "SERVE": 92.6,
+                "BLOCK": 170.4,
+                "STAMINA": 28.5
+            }
+        },
+        {
+            "rarity": "COMMON",
+            "role": "LIBERO",
+            "samples": 107794,
+            "roleBranchShare": 0,
+            "all": 541.4,
+            "focus": {
+                "ATTACK": 173.1,
+                "SET": 117.3,
+                "RECEIVE": 197.8,
+                "SERVE": 86.9,
+                "BLOCK": 174.4,
+                "STAMINA": 32.1
+            }
+        },
+        {
+            "rarity": "RARE",
+            "role": "SETTER",
+            "samples": 92252,
+            "roleBranchShare": 0.0888,
+            "all": 865.3,
+            "focus": {
+                "ATTACK": 269,
+                "SET": 239.4,
+                "RECEIVE": 299.7,
+                "SERVE": 176.2,
+                "BLOCK": 299.9,
+                "STAMINA": 40.2
+            }
+        },
+        {
+            "rarity": "RARE",
+            "role": "OUTSIDE_HITTER",
+            "samples": 18916,
+            "roleBranchShare": 0.8573,
+            "all": 691.4,
+            "focus": {
+                "ATTACK": 237.8,
+                "SET": 114.5,
+                "RECEIVE": 210.9,
+                "SERVE": 119.5,
+                "BLOCK": 207.7,
+                "STAMINA": 42.7
+            }
+        },
+        {
+            "rarity": "RARE",
+            "role": "MIDDLE_BLOCKER",
+            "samples": 92272,
+            "roleBranchShare": 0.1525,
+            "all": 899.1,
+            "focus": {
+                "ATTACK": 306.8,
+                "SET": 201.7,
+                "RECEIVE": 303.5,
+                "SERVE": 149.3,
+                "BLOCK": 339.8,
+                "STAMINA": 42.6
+            }
+        },
+        {
+            "rarity": "RARE",
+            "role": "OPPOSITE_HITTER",
+            "samples": 100116,
+            "roleBranchShare": 0.1141,
+            "all": 895.9,
+            "focus": {
+                "ATTACK": 352.3,
+                "SET": 208.1,
+                "RECEIVE": 293.3,
+                "SERVE": 173.1,
+                "BLOCK": 273.9,
+                "STAMINA": 40.3
+            }
+        },
+        {
+            "rarity": "RARE",
+            "role": "LIBERO",
+            "samples": 96444,
+            "roleBranchShare": 0.1067,
+            "all": 886.5,
+            "focus": {
+                "ATTACK": 272,
+                "SET": 225.8,
+                "RECEIVE": 349.9,
+                "SERVE": 154.5,
+                "BLOCK": 301.7,
+                "STAMINA": 44.8
+            }
+        },
+        {
+            "rarity": "LEGENDARY",
+            "role": "SETTER",
+            "samples": 68986,
+            "roleBranchShare": 0.119,
+            "all": 1077.5,
+            "focus": {
+                "ATTACK": 368.2,
+                "SET": 285.7,
+                "RECEIVE": 362.8,
+                "SERVE": 186.9,
+                "BLOCK": 355.3,
+                "STAMINA": 48.7
+            }
+        },
+        {
+            "rarity": "LEGENDARY",
+            "role": "OUTSIDE_HITTER",
+            "samples": 16108,
+            "roleBranchShare": 0.9988,
+            "all": 845.7,
+            "focus": {
+                "ATTACK": 290.2,
+                "SET": 140.7,
+                "RECEIVE": 250.7,
+                "SERVE": 145.4,
+                "BLOCK": 250.5,
+                "STAMINA": 49.5
+            }
+        },
+        {
+            "rarity": "LEGENDARY",
+            "role": "MIDDLE_BLOCKER",
+            "samples": 116110,
+            "roleBranchShare": 0.1202,
+            "all": 1090,
+            "focus": {
+                "ATTACK": 361.5,
+                "SET": 242.2,
+                "RECEIVE": 379.6,
+                "SERVE": 155.6,
+                "BLOCK": 414.7,
+                "STAMINA": 49.7
+            }
+        },
+        {
+            "rarity": "LEGENDARY",
+            "role": "OPPOSITE_HITTER",
+            "samples": 83884,
+            "roleBranchShare": 0.1336,
+            "all": 1098.1,
+            "focus": {
+                "ATTACK": 428.8,
+                "SET": 255.3,
+                "RECEIVE": 350.8,
+                "SERVE": 182.8,
+                "BLOCK": 347.6,
+                "STAMINA": 49
+            }
+        },
+        {
+            "rarity": "LEGENDARY",
+            "role": "LIBERO",
+            "samples": 114912,
+            "roleBranchShare": 0.089,
+            "all": 1098.7,
+            "focus": {
+                "ATTACK": 358.7,
+                "SET": 260.7,
+                "RECEIVE": 421.5,
+                "SERVE": 157.8,
+                "BLOCK": 381.3,
+                "STAMINA": 50.2
+            }
+        },
+        {
+            "rarity": "MYTHIC",
+            "role": "SETTER",
+            "samples": 99645,
+            "roleBranchShare": 0.0824,
+            "all": 1246.4,
+            "focus": {
+                "ATTACK": 410.6,
+                "SET": 324.7,
+                "RECEIVE": 413.3,
+                "SERVE": 236.4,
+                "BLOCK": 404,
+                "STAMINA": 66.7
+            }
+        },
+        {
+            "rarity": "MYTHIC",
+            "role": "OUTSIDE_HITTER",
+            "samples": 15991,
+            "roleBranchShare": 1,
+            "all": 962.4,
+            "focus": {
+                "ATTACK": 326.1,
+                "SET": 157,
+                "RECEIVE": 281.9,
+                "SERVE": 162.7,
+                "BLOCK": 282.2,
+                "STAMINA": 66.9
+            }
+        },
+        {
+            "rarity": "MYTHIC",
+            "role": "MIDDLE_BLOCKER",
+            "samples": 92022,
+            "roleBranchShare": 0.1535,
+            "all": 1251.8,
+            "focus": {
+                "ATTACK": 393.6,
+                "SET": 266.9,
+                "RECEIVE": 421.4,
+                "SERVE": 210.1,
+                "BLOCK": 472.7,
+                "STAMINA": 67.2
+            }
+        },
+        {
+            "rarity": "MYTHIC",
+            "role": "OPPOSITE_HITTER",
+            "samples": 99024,
+            "roleBranchShare": 0.1126,
+            "all": 1272.8,
+            "focus": {
+                "ATTACK": 485.3,
+                "SET": 288.2,
+                "RECEIVE": 396.8,
+                "SERVE": 234.5,
+                "BLOCK": 389.7,
+                "STAMINA": 66.7
+            }
+        },
+        {
+            "rarity": "MYTHIC",
+            "role": "LIBERO",
+            "samples": 93318,
+            "roleBranchShare": 0.1088,
+            "all": 1267.3,
+            "focus": {
+                "ATTACK": 391.6,
+                "SET": 290.9,
+                "RECEIVE": 482.1,
+                "SERVE": 215.1,
+                "BLOCK": 426.2,
+                "STAMINA": 67.5
+            }
+        },
+        {
+            "rarity": "SPECIAL",
+            "role": "SETTER",
+            "samples": 102997,
+            "roleBranchShare": 0.0804,
+            "all": 1457.3,
+            "focus": {
+                "ATTACK": 485.2,
+                "SET": 360.5,
+                "RECEIVE": 481.4,
+                "SERVE": 265.7,
+                "BLOCK": 475.5,
+                "STAMINA": 79
+            }
+        },
+        {
+            "rarity": "SPECIAL",
+            "role": "OUTSIDE_HITTER",
+            "samples": 16546,
+            "roleBranchShare": 0.9652,
+            "all": 1100.6,
+            "focus": {
+                "ATTACK": 371.9,
+                "SET": 183.9,
+                "RECEIVE": 323.6,
+                "SERVE": 187.1,
+                "BLOCK": 323.7,
+                "STAMINA": 79.6
+            }
+        },
+        {
+            "rarity": "SPECIAL",
+            "role": "MIDDLE_BLOCKER",
+            "samples": 87715,
+            "roleBranchShare": 0.1592,
+            "all": 1440.2,
+            "focus": {
+                "ATTACK": 463.7,
+                "SET": 309.9,
+                "RECEIVE": 482.8,
+                "SERVE": 234.3,
+                "BLOCK": 522.8,
+                "STAMINA": 79.5
+            }
+        },
+        {
+            "rarity": "SPECIAL",
+            "role": "OPPOSITE_HITTER",
+            "samples": 102830,
+            "roleBranchShare": 0.1096,
+            "all": 1469.1,
+            "focus": {
+                "ATTACK": 536.1,
+                "SET": 331.8,
+                "RECEIVE": 467.1,
+                "SERVE": 262.7,
+                "BLOCK": 463.9,
+                "STAMINA": 79.2
+            }
+        },
+        {
+            "rarity": "SPECIAL",
+            "role": "LIBERO",
+            "samples": 89912,
+            "roleBranchShare": 0.1147,
+            "all": 1462.7,
+            "focus": {
+                "ATTACK": 464.9,
+                "SET": 332.7,
+                "RECEIVE": 531.3,
+                "SERVE": 240.9,
+                "BLOCK": 490.4,
+                "STAMINA": 80.3
+            }
+        }
+    ]
+}

package/dist/esm/src/stat-config/improvement-floors.test.d.ts

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

package/dist/esm/src/stat-config/improvement-floors.test.js

@@ -0,0 +1,76 @@
+import { describe, it, expect } from '@jest/globals';
+import { createHash } from 'crypto';
+import { improvementFloorsJSON, rolesJSON, statCapsJSON } from './index';
+import { RarityEnum, RarityRanges, StaminaRanges } from '../service/player/rarity';
+import { RoleEnum } from '../service/player/role';
+import { StatsEnum, getMultipliers } from '../service/player/stats';
+import { getStatCap } from '../service/player/improvement';
+// improvement-floors.json is GENERATED (scripts/generate-improvement-floors.mjs) by sampling PlayerGenerator.
+// Nothing fails loudly if the generator's inputs change and the file is not regenerated, so the floors would
+// silently misprice every improvement in the game. These are the guards.
+//
+// The drift guard is a HASH OF THE PARSED VALUES the floors depend on, not of any source text: hashing source
+// would fail on a comment edit and force a regeneration that rewrites every number with fresh sampling noise.
+// It therefore catches a retuned role weight, stat cap or rarity range, and does NOT catch a pure logic change
+// inside player-generator.ts. That case is covered by re-running the generator deliberately.
+const RARITIES = [RarityEnum.COMMON, RarityEnum.RARE, RarityEnum.LEGENDARY, RarityEnum.MYTHIC, RarityEnum.SPECIAL];
+const ROLES = [RoleEnum.SETTER, RoleEnum.OUTSIDE_HITTER, RoleEnum.MIDDLE_BLOCKER, RoleEnum.OPPOSITE_HITTER, RoleEnum.LIBERO];
+const FOCI = [StatsEnum.ATTACK, StatsEnum.SET, StatsEnum.RECEIVE, StatsEnum.SERVE, StatsEnum.BLOCK, StatsEnum.STAMINA];
+const REGENERATE = 'improvement-floors.json is stale. Run: yarn build && yarn floors';
+describe('improvement-floors.json', () => {
+    it('was generated from the current roles, caps and rarity ranges', () => {
+        const canonical = JSON.stringify({
+            roles: rolesJSON,
+            statCaps: statCapsJSON,
+            rarityRanges: RarityRanges,
+            staminaRanges: StaminaRanges
+        });
+        const expected = createHash('sha256').update(canonical).digest('hex');
+        expect(`${improvementFloorsJSON.sourceHash}  ${REGENERATE}`).toBe(`${expected}  ${REGENERATE}`);
+    });
+    it('has exactly one entry per rarity and role', () => {
+        expect(improvementFloorsJSON.floors).toHaveLength(RARITIES.length * ROLES.length);
+        for (const rarity of RARITIES) {
+            for (const role of ROLES) {
+                const cell = improvementFloorsJSON.floors.filter(f => f.rarity === rarity && f.role === role);
+                expect(`${rarity}/${role}: ${cell.length}`).toBe(`${rarity}/${role}: 1`);
+            }
+        }
+    });
+    it('carries a floor for every training focus, matching the focus pools exactly', () => {
+        for (const entry of improvementFloorsJSON.floors) {
+            const keys = Object.keys(entry.focus).sort();
+            expect(`${entry.rarity}/${entry.role}: ${keys.join(',')}`).toBe(`${entry.rarity}/${entry.role}: ${[...FOCI].sort().join(',')}`);
+        }
+    });
+    it('keeps every floor strictly below its ceiling, so no band is degenerate', () => {
+        for (const entry of improvementFloorsJSON.floors) {
+            const cap = getStatCap(entry.rarity);
+            const label = `${entry.rarity}/${entry.role}`;
+            expect(`${label} all: ${entry.all < 18 * cap ? 'below' : 'AT OR ABOVE'} ceiling`).toBe(`${label} all: below ceiling`);
+            expect(entry.all).toBeGreaterThan(0);
+            for (const focus of FOCI) {
+                const poolSize = Object.keys(getMultipliers(focus)).length;
+                const floor = entry.focus[focus];
+                expect(`${label} ${focus}: ${floor < poolSize * cap ? 'below' : 'AT OR ABOVE'} ceiling`).toBe(`${label} ${focus}: below ceiling`);
+                expect(floor).toBeGreaterThan(0);
+            }
+        }
+    });
+    it('was sampled hard enough for every cell to be trustworthy', () => {
+        for (const entry of improvementFloorsJSON.floors) {
+            // 500 keeps the standard error of a cell mean well under a stat point; the generator warns below this.
+            expect(`${entry.rarity}/${entry.role}: ${entry.samples >= 500 ? 'enough' : `only ${entry.samples}`} samples`)
+                .toBe(`${entry.rarity}/${entry.role}: enough samples`);
+        }
+    });
+    it('records the production inputs the mixture was built from', () => {
+        expect(improvementFloorsJSON.inputs.wishlistProcRate).toBeGreaterThan(0);
+        expect(improvementFloorsJSON.inputs.wishlistAdoption).toBeGreaterThan(0);
+        expect(improvementFloorsJSON.inputs.wishlistAdoption).toBeLessThanOrEqual(1);
+        // The role branch only exists for RARE and above, so COMMON must be pure generic branch.
+        for (const entry of improvementFloorsJSON.floors.filter(f => f.rarity === RarityEnum.COMMON)) {
+            expect(`COMMON/${entry.role} roleBranchShare: ${entry.roleBranchShare}`).toBe(`COMMON/${entry.role} roleBranchShare: 0`);
+        }
+    });
+});

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

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

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

@@ -2,4 +2,7 @@ import rolesJSON from './roles.json';
 import traitsJSON from './traits.json';
 import statCapsJSON from './stat-caps.json';
 import declineProfilesJSON from './decline-profiles.json';
-export { rolesJSON, traitsJSON, statCapsJSON, declineProfilesJSON };
+// GENERATED, never hand-edited. Regenerate with `yarn build && yarn floors`; a stale file is caught by the
+// sourceHash assertion in improvement-floors.test.ts.
+import improvementFloorsJSON from './improvement-floors.json';
+export { rolesJSON, traitsJSON, statCapsJSON, declineProfilesJSON, improvementFloorsJSON };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "volleyballsimtypes",
-  "version": "0.0.493",
+  "version": "0.0.495",
   "description": "vbsim types",
   "main": "./dist/cjs/src/index.js",
   "module": "./dist/esm/src/index.js",
@@ -60,6 +60,10 @@
       "import": "./dist/esm/src/stat-config/traits.json",
       "require": "./dist/cjs/src/stat-config/traits.json"
     },
+    "./stat-config/improvement-floors.json": {
+      "import": "./dist/esm/src/stat-config/improvement-floors.json",
+      "require": "./dist/cjs/src/stat-config/improvement-floors.json"
+    },
     "./api": {
       "types": "./dist/esm/src/api/index.d.ts",
       "import": "./dist/esm/src/api/index.js",
@@ -78,7 +82,8 @@
     "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"
+    "export:schema": "powershell -NoProfile -ExecutionPolicy Bypass -File ./scripts/export-schema.ps1",
+    "floors": "node scripts/generate-improvement-floors.mjs"
   },
   "author": "Francisco Farias <fariasfranciscoe@gmail.com>",
   "license": "ISC",