volleyballsimtypes 0.0.521 → 0.0.523

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

@@ -60,7 +60,7 @@ export interface ApiPlayerInjuryStatus {
     severity: number;
     injuredUntil: string;
 }
-export type ChampionRegion = 'azureich' | 'borealas' | 'varune' | 'tirdeas';
+export type ChampionRegion = 'azureich' | 'borealas' | 'varune' | 'tirdeas' | 'kyorin';
 export type ChampionBadgeSpec = {
     type: 'league';
 } | {

package/dist/cjs/src/data/country-locales.json

@@ -47,6 +47,18 @@
     "XP": [
         "nl_NL"
     ],
+    "XQ": [
+        "pl_PL"
+    ],
+    "XR": [
+        "th_TH"
+    ],
+    "XS": [
+        "ar_SA"
+    ],
+    "XT": [
+        "en_IN"
+    ],
     "PK": [
         "bal_Arab_PK",
         "bal_Latn_PK",

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

@@ -28,6 +28,7 @@ function initModels(sequelize) {
     const PremiumGrant = models_1.PremiumGrantModel.initModel(sequelize);
     const Wishlist = models_1.WishlistModel.initModel(sequelize);
     const UserSettings = models_1.UserSettingsModel.initModel(sequelize);
+    const UserAchievements = models_1.UserAchievementsModel.initModel(sequelize);
     const UserDeviceToken = models_1.UserDeviceTokenModel.initModel(sequelize);
     const BasePositionPreset = models_1.BasePositionPresetModel.initModel(sequelize);
     const Notification = models_1.NotificationModel.initModel(sequelize);
@@ -78,6 +79,7 @@ function initModels(sequelize) {
     AuthUser.hasOne(GachaPity, { as: 'GachaPity', foreignKey: 'user_id' });
     AuthUser.hasOne(Wishlist, { as: 'Wishlist', foreignKey: 'user_id' });
     AuthUser.hasOne(UserSettings, { as: 'UserSettings', foreignKey: 'user_id' });
+    AuthUser.hasOne(UserAchievements, { as: 'UserAchievements', foreignKey: 'user_id' });
     AuthUser.hasMany(UserDeviceToken, { as: 'UserDeviceTokens', foreignKey: 'user_id' });
     AuthUser.hasMany(BasePositionPreset, { as: 'BasePositionPresets', foreignKey: 'user_id' });
     AuthUser.hasMany(Notification, { as: 'Notifications', foreignKey: 'user_id' });
@@ -101,6 +103,7 @@ function initModels(sequelize) {
     PremiumGrant.belongsTo(AuthUser, { as: 'grantedByUser', foreignKey: 'granted_by' });
     Wishlist.belongsTo(AuthUser, { as: 'user', foreignKey: 'user_id' });
     UserSettings.belongsTo(AuthUser, { as: 'user', foreignKey: 'user_id' });
+    UserAchievements.belongsTo(AuthUser, { as: 'user', foreignKey: 'user_id' });
     Competition.belongsTo(Iteration, { as: 'Iteration', foreignKey: 'iteration' });
     Competition.hasMany(CompetitionMatch, { as: 'CompetitionMatches', foreignKey: 'competition_id' });
     Competition.hasMany(CompetitionStandings, { as: 'CompetitionStandings', foreignKey: 'competition_id' });
@@ -370,6 +373,7 @@ function initModels(sequelize) {
         PremiumGrant,
         Wishlist,
         UserSettings,
+        UserAchievements,
         UserDeviceToken,
         BasePositionPreset,
         Notification,

package/dist/cjs/src/data/models/currency-transaction.d.ts

@@ -17,9 +17,10 @@ export declare enum CurrencyTransactionSourceEnum {
     SEASON_REWARD = "SEASON_REWARD",
     COMPETITION_REWARD = "COMPETITION_REWARD",
     PHYSICIAN_UPGRADE = "PHYSICIAN_UPGRADE",
-    PHYSIOTHERAPIST_UPGRADE = "PHYSIOTHERAPIST_UPGRADE"
+    PHYSIOTHERAPIST_UPGRADE = "PHYSIOTHERAPIST_UPGRADE",
+    ACHIEVEMENT_CLAIM = "ACHIEVEMENT_CLAIM"
 }
-export type CurrencyTransactionSource = CurrencyTransactionSourceEnum.MATCH_REWARD | CurrencyTransactionSourceEnum.GACHA_PULL | CurrencyTransactionSourceEnum.COACH_UPGRADE | CurrencyTransactionSourceEnum.SCOUT_UPGRADE | CurrencyTransactionSourceEnum.PLAYER_DISMISS | CurrencyTransactionSourceEnum.PLAYER_RETIRE | CurrencyTransactionSourceEnum.ADMIN_GRANT | CurrencyTransactionSourceEnum.SEASON_REWARD | CurrencyTransactionSourceEnum.COMPETITION_REWARD | CurrencyTransactionSourceEnum.PHYSICIAN_UPGRADE | CurrencyTransactionSourceEnum.PHYSIOTHERAPIST_UPGRADE;
+export type CurrencyTransactionSource = CurrencyTransactionSourceEnum.MATCH_REWARD | CurrencyTransactionSourceEnum.GACHA_PULL | CurrencyTransactionSourceEnum.COACH_UPGRADE | CurrencyTransactionSourceEnum.SCOUT_UPGRADE | CurrencyTransactionSourceEnum.PLAYER_DISMISS | CurrencyTransactionSourceEnum.PLAYER_RETIRE | CurrencyTransactionSourceEnum.ADMIN_GRANT | CurrencyTransactionSourceEnum.SEASON_REWARD | CurrencyTransactionSourceEnum.COMPETITION_REWARD | CurrencyTransactionSourceEnum.PHYSICIAN_UPGRADE | CurrencyTransactionSourceEnum.PHYSIOTHERAPIST_UPGRADE | CurrencyTransactionSourceEnum.ACHIEVEMENT_CLAIM;
 export interface CurrencyTransactionAttributes {
     transaction_id: string;
     user_id: string;

package/dist/cjs/src/data/models/currency-transaction.js

@@ -20,6 +20,7 @@ var CurrencyTransactionSourceEnum;
     CurrencyTransactionSourceEnum["COMPETITION_REWARD"] = "COMPETITION_REWARD";
     CurrencyTransactionSourceEnum["PHYSICIAN_UPGRADE"] = "PHYSICIAN_UPGRADE";
     CurrencyTransactionSourceEnum["PHYSIOTHERAPIST_UPGRADE"] = "PHYSIOTHERAPIST_UPGRADE";
+    CurrencyTransactionSourceEnum["ACHIEVEMENT_CLAIM"] = "ACHIEVEMENT_CLAIM";
 })(CurrencyTransactionSourceEnum || (exports.CurrencyTransactionSourceEnum = CurrencyTransactionSourceEnum = {}));
 class CurrencyTransactionModel extends sequelize_1.Model {
     static initModel(sequelize) {

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

@@ -58,6 +58,7 @@ export * from './wishlist';
 export * from './currency-transaction';
 export * from './user-pull-grant';
 export * from './user-settings';
+export * from './user-achievements';
 export * from './user-device-token';
 export * from './notification';
 export * from './vper';

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

@@ -74,6 +74,7 @@ __exportStar(require("./wishlist"), exports);
 __exportStar(require("./currency-transaction"), exports);
 __exportStar(require("./user-pull-grant"), exports);
 __exportStar(require("./user-settings"), exports);
+__exportStar(require("./user-achievements"), exports);
 __exportStar(require("./user-device-token"), exports);
 __exportStar(require("./notification"), exports);
 __exportStar(require("./vper"), exports);

package/dist/cjs/src/data/models/user-achievements.d.ts

@@ -0,0 +1,19 @@
+import * as Sequelize from 'sequelize';
+import { Model } from 'sequelize';
+import { AuthUserId, AuthUserModel } from '.';
+export interface UserAchievementsAttributes {
+    user_id: string;
+    achievements: Record<string, string>;
+}
+export type UserAchievementsPk = 'user_id';
+export type UserAchievementsId = UserAchievementsModel[UserAchievementsPk];
+export type UserAchievementsCreationAttributes = Sequelize.Optional<UserAchievementsAttributes, 'achievements'>;
+export declare class UserAchievementsModel extends Model<UserAchievementsAttributes, UserAchievementsCreationAttributes> implements UserAchievementsAttributes {
+    user_id: string;
+    achievements: Record<string, string>;
+    user: AuthUserModel;
+    getUser: Sequelize.BelongsToGetAssociationMixin<AuthUserModel>;
+    setUser: Sequelize.BelongsToSetAssociationMixin<AuthUserModel, AuthUserId>;
+    createUser: Sequelize.BelongsToCreateAssociationMixin<AuthUserModel>;
+    static initModel(sequelize: Sequelize.Sequelize): typeof UserAchievementsModel;
+}

package/dist/cjs/src/data/models/user-achievements.js

@@ -0,0 +1,37 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UserAchievementsModel = void 0;
+const sequelize_1 = require("sequelize");
+class UserAchievementsModel extends sequelize_1.Model {
+    static initModel(sequelize) {
+        return UserAchievementsModel.init({
+            user_id: {
+                type: sequelize_1.DataTypes.UUID,
+                allowNull: false,
+                primaryKey: true,
+                references: {
+                    model: 'AuthUser',
+                    key: 'user_id'
+                }
+            },
+            achievements: {
+                type: sequelize_1.DataTypes.JSONB,
+                allowNull: false,
+                defaultValue: {}
+            }
+        }, {
+            sequelize,
+            tableName: 'UserAchievements',
+            schema: 'public',
+            timestamps: false,
+            indexes: [
+                {
+                    name: 'UserAchievements_pk',
+                    unique: true,
+                    fields: [{ name: 'user_id' }]
+                }
+            ]
+        });
+    }
+}
+exports.UserAchievementsModel = UserAchievementsModel;

package/dist/cjs/src/service/achievement/achievement-status.d.ts

@@ -0,0 +1,5 @@
+export declare enum AchievementStatus {
+    NOT_DONE = "NOT_DONE",
+    DONE = "DONE",
+    CLAIMED = "CLAIMED"
+}

package/dist/cjs/src/service/achievement/achievement-status.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AchievementStatus = void 0;
+// Per-user achievement progress state. Stored only inside the UserAchievements.achievements jsonb map
+// (achievementKey -> status); an absent key means NOT_DONE, so no data backfill is ever needed when new
+// achievements are added. Because it lives only inside jsonb it is NOT a Sequelize DataTypes.ENUM and has no
+// Postgres CREATE TYPE (mirrors how Tactics stores RoleEnum values inside jsonb without a DB enum).
+var AchievementStatus;
+(function (AchievementStatus) {
+    AchievementStatus["NOT_DONE"] = "NOT_DONE";
+    AchievementStatus["DONE"] = "DONE";
+    AchievementStatus["CLAIMED"] = "CLAIMED";
+})(AchievementStatus || (exports.AchievementStatus = AchievementStatus = {}));

package/dist/cjs/src/service/achievement/achievement-type.d.ts

@@ -0,0 +1,24 @@
+import { AchievementStatus } from './achievement-status';
+export declare const ACHIEVEMENT_KEYS: readonly ["NORMAL_RECRUIT", "SPECIAL_RECRUIT", "DISMISS_PLAYER", "RETIRE_PLAYER", "GIVE_NICKNAME", "PLAY_MATCH", "WIN_MATCH", "FINISH_LEAGUE_SEASON", "UPGRADE_COACH", "UPGRADE_SCOUT", "UPGRADE_PHYSICIAN", "UPGRADE_PHYSIOTHERAPIST", "CHANGE_TRAINING_FOCUS", "CHANGE_TACTICS", "REGISTER_EVENT", "WIN_LEAGUE", "WIN_NATIONALS", "WIN_REGIONALS", "WIN_WCC", "READ_WIKI", "CLAIM_DAILY", "VIEW_MATCH", "PREVIEW_MATCH"];
+export type AchievementKey = typeof ACHIEVEMENT_KEYS[number];
+export declare const ACHIEVEMENT_REWARD = 500;
+export declare const MILESTONE_ACHIEVEMENTS: readonly AchievementKey[];
+export declare function isMilestone(key: AchievementKey): boolean;
+export declare const MILESTONE_THRESHOLDS: readonly number[];
+export declare function nextMilestone(claimedLevel: number): number | null;
+export interface MilestoneProgress {
+    c: number;
+    l: number;
+}
+export interface MilestoneState {
+    count: number;
+    claimed: number;
+    target: number | null;
+    claimable: boolean;
+    maxed: boolean;
+}
+export declare function milestoneState(value: unknown): MilestoneState;
+export type AchievementMap = Partial<Record<AchievementKey, AchievementStatus | MilestoneProgress>>;
+export declare const CLIENT_COMPLETABLE_ACHIEVEMENTS: readonly AchievementKey[];
+export declare function isAchievementKey(value: string): value is AchievementKey;
+export declare function isClientCompletable(key: AchievementKey): boolean;

package/dist/cjs/src/service/achievement/achievement-type.js

@@ -0,0 +1,85 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CLIENT_COMPLETABLE_ACHIEVEMENTS = exports.MILESTONE_THRESHOLDS = exports.MILESTONE_ACHIEVEMENTS = exports.ACHIEVEMENT_REWARD = exports.ACHIEVEMENT_KEYS = void 0;
+exports.isMilestone = isMilestone;
+exports.nextMilestone = nextMilestone;
+exports.milestoneState = milestoneState;
+exports.isAchievementKey = isAchievementKey;
+exports.isClientCompletable = isClientCompletable;
+// Single source of truth for the set of achievement keys (the tutorial checklist). Adding an achievement:
+//   1. add its key here,
+//   2. add its display config in the UI (src/view/achievements/achievements-config.ts),
+//   3. add its name + description to every locale file,
+//   4. wire its completion trigger (API handler or sim engine) to call completeAchievement.
+// The key is only ever a jsonb map key, so there is no Postgres enum/column to migrate when the list grows.
+exports.ACHIEVEMENT_KEYS = [
+    'NORMAL_RECRUIT',
+    'SPECIAL_RECRUIT',
+    'DISMISS_PLAYER',
+    'RETIRE_PLAYER',
+    'GIVE_NICKNAME',
+    'PLAY_MATCH',
+    'WIN_MATCH',
+    'FINISH_LEAGUE_SEASON',
+    'UPGRADE_COACH',
+    'UPGRADE_SCOUT',
+    'UPGRADE_PHYSICIAN',
+    'UPGRADE_PHYSIOTHERAPIST',
+    'CHANGE_TRAINING_FOCUS',
+    'CHANGE_TACTICS',
+    'REGISTER_EVENT',
+    'WIN_LEAGUE',
+    'WIN_NATIONALS',
+    'WIN_REGIONALS',
+    'WIN_WCC',
+    'READ_WIKI',
+    'CLAIM_DAILY',
+    'VIEW_MATCH',
+    'PREVIEW_MATCH'
+];
+// Every achievement grants the same flat coin reward when the user claims it (each milestone reached is a fresh claim).
+exports.ACHIEVEMENT_REWARD = 500;
+// Recurring "milestone" achievements: instead of a one-shot NOT_DONE->DONE->CLAIMED status, these store a running count
+// and re-arm at escalating thresholds. Their map value is a MilestoneProgress object, not a status string.
+exports.MILESTONE_ACHIEVEMENTS = [
+    'CLAIM_DAILY',
+    'PLAY_MATCH',
+    'WIN_MATCH',
+    'NORMAL_RECRUIT',
+    'DISMISS_PLAYER',
+    'WIN_LEAGUE',
+    'WIN_NATIONALS',
+    'WIN_REGIONALS',
+    'WIN_WCC'
+];
+function isMilestone(key) {
+    return exports.MILESTONE_ACHIEVEMENTS.includes(key);
+}
+// The claim thresholds every milestone steps through (x5, x2 alternating). Past the last one the milestone is "maxed".
+exports.MILESTONE_THRESHOLDS = [1, 5, 10, 50, 100, 500, 1000, 5000, 10000, 50000, 100000, 500000, 1000000];
+// The next threshold strictly greater than `claimedLevel` (0 = nothing claimed yet), or null when all are claimed.
+function nextMilestone(claimedLevel) {
+    return exports.MILESTONE_THRESHOLDS.find(t => t > claimedLevel) ?? null;
+}
+// Derive a milestone's display/claim state from its raw map value (a MilestoneProgress object, a legacy status string,
+// or undefined). Anything that is not a well-formed object counts as no progress ({c:0, l:0}). Shared by the API claim
+// path and the UI.
+function milestoneState(value) {
+    const mp = (value != null && typeof value === 'object') ? value : {};
+    const count = typeof mp.c === 'number' && Number.isFinite(mp.c) ? mp.c : 0;
+    const claimed = typeof mp.l === 'number' && Number.isFinite(mp.l) ? mp.l : 0;
+    const target = nextMilestone(claimed);
+    return { count, claimed, target, claimable: target != null && count >= target, maxed: target == null };
+}
+// Achievements the client is allowed to self-complete because there is no server-side action to hook: opening the
+// wiki and opening a match detail. The POST /achievements/:key/complete endpoint MUST reject any key not in this set,
+// so a client can never self-complete a server-authoritative achievement (recruit, win, upgrade, ...).
+exports.CLIENT_COMPLETABLE_ACHIEVEMENTS = ['READ_WIKI', 'VIEW_MATCH', 'PREVIEW_MATCH'];
+// Whether `value` is one of the known achievement keys (use before trusting a request param).
+function isAchievementKey(value) {
+    return exports.ACHIEVEMENT_KEYS.includes(value);
+}
+// Whether the client is allowed to fire completion for this key (only READ_WIKI / VIEW_MATCH).
+function isClientCompletable(key) {
+    return exports.CLIENT_COMPLETABLE_ACHIEVEMENTS.includes(key);
+}

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

@@ -0,0 +1,3 @@
+export * from './achievement-status';
+export * from './achievement-type';
+export * from './schemas/achievements.z';

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

@@ -0,0 +1,19 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./achievement-status"), exports);
+__exportStar(require("./achievement-type"), exports);
+__exportStar(require("./schemas/achievements.z"), exports);

package/dist/cjs/src/service/achievement/schemas/achievements.z.d.ts

@@ -0,0 +1,3 @@
+import { z } from 'zod';
+import { AchievementStatus } from '../achievement-status';
+export declare const achievementMapSchema: z.ZodRecord<z.ZodString, z.ZodEnum<typeof AchievementStatus>>;

package/dist/cjs/src/service/achievement/schemas/achievements.z.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.achievementMapSchema = void 0;
+const zod_1 = require("zod");
+const achievement_status_1 = require("../achievement-status");
+// Validates a UserAchievements.achievements jsonb map (achievementKey -> status). Keys are loose strings so an
+// unknown/legacy key never fails validation; values must be a known AchievementStatus. Mirrors the z.record idiom
+// used by Tactics (tactics.z.ts).
+exports.achievementMapSchema = zod_1.z.record(zod_1.z.string(), zod_1.z.nativeEnum(achievement_status_1.AchievementStatus));

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

@@ -6,4 +6,5 @@ export * from './player';
 export * from './competition';
 export * from './notification';
 export * from './premium';
+export * from './achievement';
 export * from './utils';

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

@@ -22,4 +22,5 @@ __exportStar(require("./player"), exports);
 __exportStar(require("./competition"), exports);
 __exportStar(require("./notification"), exports);
 __exportStar(require("./premium"), exports);
+__exportStar(require("./achievement"), exports);
 __exportStar(require("./utils"), exports);

package/dist/cjs/src/service/match/vper.js

@@ -13,11 +13,14 @@ const WEIGHTS = {
     BLOCK_TOUCH: 0.2,
     DEFENSE_DIG: 0.25,
     SETTING_PASS: 0.15,
+    // A swing that neither killed nor was stuffed nor sailed: the ball is still alive and the defence had to play it.
+    ATTACK_IN_PLAY: 0.10,
     // reception quality
     RECEPTION_PERFECT: 0.35,
     RECEPTION_POSITIVE: 0.15,
     RECEPTION_OVERPASS: -0.6,
-    // terminal errors (always point against)
+    // terminal errors (always point against). A stuffed attack is booked as an attack error by the simulator, so
+    // being blocked is penalised here at the same -1.0 as a swing into the net.
     TERMINAL_ERROR: -1.0
 };
 // Minimum points a player must be on court for in a match to receive a VPER. VPER is a per-100-points rate,
@@ -47,14 +50,31 @@ class VPER {
         let pointsPlayedSum = 0;
         for (const box of boxScores) {
             const w = WEIGHTS;
+            // Each action is scored ONCE, at its highest-value outcome. A set that became a kill is an assist, not an
+            // assist plus a pass; a touch that became a stuff is a block point, not a block point plus a touch. The
+            // subtractions below strip the lower-value credit that the simulator books alongside the terminal one.
+            //
+            // Each remainder is clamped at 0. A well-formed row can never make one negative (a swing yields at most one
+            // of {kill, error}; every assist belongs to a set that booked a pass on this same row; BlockStatsSchema
+            // enforces solo + assists <= touches), so the clamp only guards against a malformed or hand-built row
+            // silently turning a subtraction into a bonus.
+            //
+            // A swing that stayed alive: attempts minus the ones that terminated (a kill, or an error, which now
+            // includes being stuffed).
+            const inPlayAttacks = Math.max(0, box.attack.attempts - box.attack.kills - box.attack.errors);
+            // Sets that did NOT convert into a kill.
+            const unconvertedSets = Math.max(0, box.setting.pass - box.setting.assists);
+            // Touches that did not become a block point.
+            const nonScoringTouches = Math.max(0, box.block.touches - box.block.solo - box.block.assists);
             const positive = w.ATTACK_KILL * box.attack.kills +
+                w.ATTACK_IN_PLAY * inPlayAttacks +
                 w.SERVE_ACE * box.serve.aces +
                 w.BLOCK_SOLO * box.block.solo +
                 w.BLOCK_ASSIST * box.block.assists +
                 w.SETTING_ASSIST * box.setting.assists +
-                w.BLOCK_TOUCH * box.block.touches +
+                w.BLOCK_TOUCH * nonScoringTouches +
                 w.DEFENSE_DIG * box.defense.digs +
-                w.SETTING_PASS * box.setting.pass +
+                w.SETTING_PASS * unconvertedSets +
                 w.RECEPTION_PERFECT * box.reception.perfect +
                 w.RECEPTION_POSITIVE * box.reception.positive;
             const negative = w.RECEPTION_OVERPASS * box.reception.overpasses +

package/dist/cjs/src/service/match/vper.test.js

@@ -106,6 +106,92 @@ function makeBox() {
         (0, globals_1.expect)(vper_1.VPER.computeVPERForMatch([box])).toBeCloseTo(14, 5);
     });
 });
+// ─── each action scores once, at its highest-value outcome ────────────────────
+(0, globals_1.describe)('VPER.computeVPERForMatch() — no double-counting', () => {
+    (0, globals_1.it)('scores a converted set as an assist only, never assist + pass', () => {
+        const box = makeBox();
+        box.setting.pass = 1;
+        box.setting.assists = 1;
+        box.misc.pointsPlayed = 10;
+        // unconvertedSets = 1 - 1 = 0, so the setter earns 0.7, not 0.85.
+        (0, globals_1.expect)(vper_1.VPER.computeVPERForMatch([box])).toBeCloseTo(7, 5);
+    });
+    (0, globals_1.it)('pays the pass weight only on sets that did not convert', () => {
+        const box = makeBox();
+        box.setting.pass = 10;
+        box.setting.assists = 4;
+        box.misc.pointsPlayed = 10;
+        // assists 4 * 0.7 = 2.8; unconverted 6 * 0.15 = 0.9; raw 3.7
+        (0, globals_1.expect)(vper_1.VPER.computeVPERForMatch([box])).toBeCloseTo(37, 5);
+    });
+    (0, globals_1.it)('scores a solo stuff as a block point only, never solo + touch', () => {
+        const box = makeBox();
+        box.block.touches = 1;
+        box.block.solo = 1;
+        box.misc.pointsPlayed = 10;
+        // nonScoringTouches = 1 - 1 - 0 = 0, so the blocker earns 1.0, not 1.2.
+        (0, globals_1.expect)(vper_1.VPER.computeVPERForMatch([box])).toBeCloseTo(10, 5);
+    });
+    (0, globals_1.it)('pays the touch weight only on touches that did not become a point', () => {
+        const box = makeBox();
+        box.block.touches = 5;
+        box.block.solo = 1;
+        box.block.assists = 2;
+        box.misc.pointsPlayed = 10;
+        // solo 1.0 + assists 2 * 0.5 = 1.0 + nonScoringTouches 2 * 0.2 = 0.4; raw 2.4
+        (0, globals_1.expect)(vper_1.VPER.computeVPERForMatch([box])).toBeCloseTo(24, 5);
+    });
+    (0, globals_1.it)('never lets a malformed row turn a subtraction into a bonus', () => {
+        // kills without attempts, assists without passes, blocks without touches: every remainder clamps to 0.
+        const box = makeBox();
+        box.attack.kills = 5;
+        box.setting.assists = 10;
+        box.block.solo = 3;
+        box.misc.pointsPlayed = 10;
+        // 5 * 1.0 + 10 * 0.7 + 3 * 1.0 = 15, with no negative remainder contribution
+        (0, globals_1.expect)(vper_1.VPER.computeVPERForMatch([box])).toBeCloseTo(150, 5);
+    });
+});
+// ─── the non-scoring attack ──────────────────────────────────────────────────
+(0, globals_1.describe)('VPER.computeVPERForMatch() — attack outcomes', () => {
+    (0, globals_1.it)('rewards a swing that stays in play (weight 0.10)', () => {
+        const box = makeBox();
+        box.attack.attempts = 10;
+        box.attack.kills = 3;
+        box.attack.errors = 1;
+        box.misc.pointsPlayed = 10;
+        // kills 3 * 1.0 = 3; inPlay (10 - 3 - 1) = 6 * 0.10 = 0.6; errors 1 * -1.0; raw 2.6
+        (0, globals_1.expect)(vper_1.VPER.computeVPERForMatch([box])).toBeCloseTo(26, 5);
+    });
+    (0, globals_1.it)('penalises a stuffed swing at -1.0 (the simulator books it as an attack error)', () => {
+        const box = makeBox();
+        box.attack.attempts = 1;
+        box.attack.errors = 1;
+        box.misc.pointsPlayed = 10;
+        // inPlay = 0; the stuff is a terminal error
+        (0, globals_1.expect)(vper_1.VPER.computeVPERForMatch([box])).toBeCloseTo(-10, 5);
+    });
+    (0, globals_1.it)('separates volume from efficiency: more dug swings for the same kills rates higher', () => {
+        const efficient = makeBox();
+        efficient.attack.attempts = 12;
+        efficient.attack.kills = 10;
+        efficient.misc.pointsPlayed = 100;
+        const volume = makeBox();
+        volume.attack.attempts = 30;
+        volume.attack.kills = 10;
+        volume.misc.pointsPlayed = 100;
+        // Pre-fix both scored exactly 10.0. Now the extra 18 dug swings are worth 0.10 each.
+        (0, globals_1.expect)(vper_1.VPER.computeVPERForMatch([efficient])).toBeCloseTo(10.2, 5);
+        (0, globals_1.expect)(vper_1.VPER.computeVPERForMatch([volume])).toBeCloseTo(12.0, 5);
+    });
+    (0, globals_1.it)('a swing that is killed scores the kill, not the kill plus an in-play credit', () => {
+        const box = makeBox();
+        box.attack.attempts = 1;
+        box.attack.kills = 1;
+        box.misc.pointsPlayed = 10;
+        (0, globals_1.expect)(vper_1.VPER.computeVPERForMatch([box])).toBeCloseTo(10, 5);
+    });
+});
 // ─── VPER eligibility threshold ───────────────────────────────────────────────
 (0, globals_1.describe)('VPER.qualifiesForVPER()', () => {
     function boxWithPoints(points) {

package/dist/cjs/src/service/notification/catalog/en.json

@@ -58,5 +58,9 @@
         "title": "Event finished",
         "body": "The event is over. See the final table and your rewards.",
         "placed": "The event is over. You finished {{position}} of {{entrants}}."
+    },
+    "regionRelocation": {
+        "title": "Your team is moving",
+        "body": "Your team has been chosen to be moved to the new region: Kyorin. Nothing has changed in terms of the team you manage, your players or anything else."
     }
 }

package/dist/cjs/src/service/notification/catalog/es.json

@@ -58,5 +58,9 @@
         "title": "Evento terminado",
         "body": "El evento ha terminado. Mira la tabla final y tus recompensas.",
         "placed": "El evento ha terminado. Has quedado {{position}} de {{entrants}}."
+    },
+    "regionRelocation": {
+        "title": "Tu equipo se traslada",
+        "body": "Tu equipo ha sido elegido para trasladarse a la nueva región: Kyorin. No cambia nada en cuanto al equipo que gestionas, tus jugadores ni nada más."
     }
 }

package/dist/cjs/src/service/notification/catalog/fr.json

@@ -58,5 +58,9 @@
         "title": "Événement terminé",
         "body": "L'événement est terminé. Consulte le classement final et tes récompenses.",
         "placed": "L'événement est terminé. Tu finis {{position}} sur {{entrants}}."
+    },
+    "regionRelocation": {
+        "title": "Votre équipe déménage",
+        "body": "Votre équipe a été choisie pour être transférée vers la nouvelle région : Kyorin. Rien ne change concernant l'équipe que vous gérez, vos joueurs ni quoi que ce soit d'autre."
     }
 }

package/dist/cjs/src/service/notification/catalog/it.json

@@ -58,5 +58,9 @@
         "title": "Evento concluso",
         "body": "L'evento è finito. Guarda la classifica finale e i tuoi premi.",
         "placed": "L'evento è finito. Hai chiuso {{position}} su {{entrants}}."
+    },
+    "regionRelocation": {
+        "title": "La tua squadra si trasferisce",
+        "body": "La tua squadra è stata scelta per essere spostata nella nuova regione: Kyorin. Non cambia nulla riguardo alla squadra che gestisci, ai tuoi giocatori o a qualsiasi altra cosa."
     }
 }

package/dist/cjs/src/service/notification/catalog/pl.json

@@ -58,5 +58,9 @@
         "title": "Wydarzenie zakończone",
         "body": "Wydarzenie się skończyło. Zobacz tabelę końcową i nagrody.",
         "placed": "Wydarzenie się skończyło. Zająłeś {{position}} miejsce na {{entrants}}."
+    },
+    "regionRelocation": {
+        "title": "Twoja drużyna się przenosi",
+        "body": "Twoja drużyna została wybrana do przeniesienia do nowego regionu: Kyorin. Nic się nie zmienia, jeśli chodzi o zarządzaną przez ciebie drużynę, twoich zawodników ani cokolwiek innego."
     }
 }

package/dist/cjs/src/service/notification/catalog/pt-BR.json

@@ -58,5 +58,9 @@
         "title": "Evento encerrado",
         "body": "O evento acabou. Veja a tabela final e suas recompensas.",
         "placed": "O evento acabou. Você terminou em {{position}} de {{entrants}}."
+    },
+    "regionRelocation": {
+        "title": "Seu time está mudando",
+        "body": "Seu time foi escolhido para ser movido para a nova região: Kyorin. Nada muda em relação ao time que você gerencia, seus jogadores ou qualquer outra coisa."
     }
 }

package/dist/cjs/src/service/notification/catalog/tr.json

@@ -58,5 +58,9 @@
         "title": "Etkinlik bitti",
         "body": "Etkinlik sona erdi. Final tablosuna ve ödüllerine bak.",
         "placed": "Etkinlik sona erdi. {{entrants}} takım arasında {{position}}. oldun."
+    },
+    "regionRelocation": {
+        "title": "Takımın taşınıyor",
+        "body": "Takımın yeni bölgeye, Kyorin'e taşınmak üzere seçildi. Yönettiğin takım, oyuncuların ya da başka hiçbir şey açısından hiçbir şey değişmiyor."
     }
 }

package/dist/cjs/src/service/notification/notification-type.d.ts

@@ -1,4 +1,4 @@
-export declare const NOTIFICATION_TYPES: readonly ["MATCH_RESULT", "INJURY", "INJURY_RECOVERED", "SEASON_END", "GRANT_RECEIVED", "PROMOTION", "DAILY_LOGIN", "WELCOME", "COMPENSATION", "EVENT_REGISTRATION_OPEN", "EVENT_REGISTRATION_CLOSING", "EVENT_STARTED", "EVENT_FINAL_ROUND", "EVENT_FINISHED"];
+export declare const NOTIFICATION_TYPES: readonly ["MATCH_RESULT", "INJURY", "INJURY_RECOVERED", "SEASON_END", "GRANT_RECEIVED", "PROMOTION", "DAILY_LOGIN", "WELCOME", "COMPENSATION", "EVENT_REGISTRATION_OPEN", "EVENT_REGISTRATION_CLOSING", "EVENT_STARTED", "EVENT_FINAL_ROUND", "EVENT_FINISHED", "REGION_RELOCATION"];
 export type NotificationType = typeof NOTIFICATION_TYPES[number];
 export declare const NOTIFICATION_LOCALES: readonly ["en", "es", "fr", "it", "pl", "pt-BR", "tr"];
 export type NotificationLocale = typeof NOTIFICATION_LOCALES[number];

package/dist/cjs/src/service/notification/notification-type.js

@@ -21,7 +21,8 @@ exports.NOTIFICATION_TYPES = [
     'EVENT_REGISTRATION_CLOSING',
     'EVENT_STARTED',
     'EVENT_FINAL_ROUND',
-    'EVENT_FINISHED'
+    'EVENT_FINISHED',
+    'REGION_RELOCATION'
 ];
 // The 7 supported locales. Must stay in sync with the API VALID_LOCALES set and the UI src/locales/*.json.
 exports.NOTIFICATION_LOCALES = ['en', 'es', 'fr', 'it', 'pl', 'pt-BR', 'tr'];

package/dist/cjs/src/service/notification/registry.js

@@ -162,6 +162,15 @@ exports.NOTIFICATION_REGISTRY = {
         emitsPush: false,
         richRender: 'COMPENSATION',
         catalogKeys: []
+    },
+    // One-off relocation warning: sent to users whose team is being moved to Kyorin. Informational; opens their team.
+    REGION_RELOCATION: {
+        emitsPush: true,
+        deepLink: teamPath,
+        pushTitleKey: 'regionRelocation.title',
+        pushBodyKey: 'regionRelocation.body',
+        inAppMessageKey: 'regionRelocation.body',
+        catalogKeys: ['regionRelocation.title', 'regionRelocation.body']
     }
 };
 // The notification types that emit a mobile push (everything except COMPENSATION). Source of truth = each

package/dist/cjs/src/service/team/base-config.js

@@ -5,10 +5,14 @@
 // (and populated from a picked default preset); consumed by the positional engine to place players. A team with no
 // `basePositions` falls back to the default preset for its `rotationSystem`.
 //
-// KEYING: rotation 1..6 and zone 1..6 are the ROTATIONAL (at-the-whistle) slots. The stored rotation convention is
-// the ENGINE's (SETTER_ZONE_TO_ROTATION); the UI editor re-keys the mapper's setter-zone rotation to it on save.
-// `coords[formation][rotation][zone]` is the standing coordinate for that formation; `receive[rotation][zone]` is
-// the reception-participation flag (absent zone => default to participating).
+// KEYING: rotation 1..6 and zone 1..6 are the ROTATIONAL (at-the-whistle) slots. The `rotation` key is the MAIN
+// designated setter's (designatedSetters[0]) rotational ZONE, raw 1..6 (`rotation` == that setter's zone; there is
+// NO setter-zone->rotation remap). This is the single convention everywhere: the editor writes it (posOf anchored on
+// the main setter, saved verbatim), the engine reads it (positioning.rotationOf = getMainSetter zone), and the
+// offensive/tempo/blocking prefs key by mainSetter.position. `coords[formation][rotation][zone]` is the standing
+// coordinate for that formation; `receive[rotation][zone]` is the reception-participation flag (absent zone => default
+// to participating). (History: rotationOf once remapped via SETTER_ZONE_TO_ROTATION and defaultReceiveMap once keyed
+// by that index; both were unified to the raw main-setter zone. See VolleyballSim/plans/rotation-key-main-setter.md.)
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.BASE_FORMATIONS = void 0;
 exports.BASE_FORMATIONS = ['SERVE', 'RECEIVE', 'DEFENCE', 'DEF_L', 'DEF_M', 'DEF_R', 'ATTACK'];