volleyballsimtypes 0.0.521 → 0.0.523

package/dist/esm/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/esm/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/esm/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/esm/src/service/notification/notification-type.js

@@ -16,7 +16,8 @@ export const 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.
 export const NOTIFICATION_LOCALES = ['en', 'es', 'fr', 'it', 'pl', 'pt-BR', 'tr'];

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

@@ -159,6 +159,15 @@ export const 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/esm/src/service/team/base-config.js

@@ -4,8 +4,12 @@
 // (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.)
 export const BASE_FORMATIONS = ['SERVE', 'RECEIVE', 'DEFENCE', 'DEF_L', 'DEF_M', 'DEF_R', 'ATTACK'];

package/dist/esm/src/service/team/default-base-config.js

@@ -195,22 +195,24 @@ const DEFAULT_5_1_RECEIVE = {
     5: { 1: true, 2: false, 3: true, 4: false, 5: false, 6: true },
     6: { 1: true, 2: false, 3: false, 4: true, 5: true, 6: false }
 };
-// Rotation index -> the setter's rotational zone (inverse of SETTER_ZONE_TO_ROTATION {1:1,6:2,5:3,4:4,3:5,2:6}).
-const ROTATION_TO_SETTER_ZONE = { 1: 1, 2: 6, 3: 5, 4: 4, 5: 3, 6: 2 };
-// The default serve-receive participation map: the standard 3-passer formation. A rotational slot passes iff its
-// slot function is an OUTSIDE_HITTER (either row) or a BACK-ROW MIDDLE_BLOCKER (the libero's slot). The setter, the
-// opposite and the front-row middle hide. slotFunctionAt maps the opposite slot to SETTER in 4-2/6-2, so the
-// second setter is excluded too, giving the same 3-passer map for every system.
+// The default serve-receive participation map: the standard 3-passer formation. Keyed by the MAIN setter's rotational
+// ZONE (raw 1..6 = the canonical convention: receive[Z] describes the formation with the setter at zone Z), matching
+// DEFAULT_5_1_RECEIVE, the PRESET_6_2/PRESET_4_2 presets, the tactics editor, and the engine's rotationOf. A rotational
+// slot passes iff its slot function is an OUTSIDE_HITTER (either row) or a BACK-ROW MIDDLE_BLOCKER (the libero's slot);
+// the setter, the opposite and the front-row middle hide. slotFunctionAt maps the opposite slot to SETTER in 4-2/6-2,
+// so the second setter is excluded too, giving the same 3-passer map for every system.
+// (History: this used to key by a rotation INDEX via ROTATION_TO_SETTER_ZONE {1:1,2:6,3:5,4:4,5:3,6:2}, a leftover of
+// the old setter-zone->rotation remap removed from rotationOf; that transposed the non-5-1 default receive maps at
+// rotations 2/3/5/6. Fixed 2026-08-23, see VolleyballSim/plans/rotation-key-main-setter.md + the re-key migration.)
 export function defaultReceiveMap(system) {
     const receive = {};
-    for (let rotation = 1; rotation <= 6; rotation++) {
-        const setterZone = ROTATION_TO_SETTER_ZONE[rotation];
+    for (let setterZone = 1; setterZone <= 6; setterZone++) {
         const perZone = {};
         for (let zone = 1; zone <= 6; zone++) {
             const fn = slotFunctionAt(system, setterZone, zone);
             perZone[String(zone)] = fn === RoleEnum.OUTSIDE_HITTER || (fn === RoleEnum.MIDDLE_BLOCKER && isBackRow(zone));
         }
-        receive[String(rotation)] = perZone;
+        receive[String(setterZone)] = perZone;
     }
     return receive;
 }

package/dist/esm/src/service/team/default-base-config.test.js

@@ -1,7 +1,59 @@
 import { RotationSystemEnum } from './rotation-system';
-import { defaultBaseConfig } from './default-base-config';
+import { defaultBaseConfig, defaultReceiveMap } from './default-base-config';
+import { baseConfigViolations } from './receive-overlap';
 // Back-row rotational zones (right/left/middle back). Front row is {2,3,4}.
 const BACK_ROW = new Set([1, 5, 6]);
+// The editor and the sim BOTH fall back to defaultBaseConfig for a zone a config leaves unset, so the default base
+// MUST itself pass the FIVB overlap / serve-line rules in every rotation. Otherwise a partial config (some zones
+// stored, others defaulted) can render/commit an unset zone onto a neighbour and read "out of rotation even in
+// base" for a formation the sim runs legally (rush6@ tournament report, 2026-08-21).
+// The default receive map must key by the MAIN setter's RAW rotational zone (receive[R] describes the formation with
+// the setter at zone R), the single canonical convention shared by DEFAULT_5_1_RECEIVE, the PRESET_6_2/4_2 presets,
+// the tactics editor, and the engine's rotationOf. It used to key by a rotation INDEX (ROTATION_TO_SETTER_ZONE), which
+// transposed non-5-1 maps at rotations 2/3/5/6 (fixed 2026-08-23; see plans/rotation-key-main-setter.md).
+describe('defaultReceiveMap: raw main-setter-zone convention', () => {
+    it('5-1: the computed map equals the hand-authored raw DEFAULT_5_1_RECEIVE', () => {
+        // defaultBaseConfig(5-1).receive IS the hand-authored DEFAULT_5_1_RECEIVE. The computed map matching it proves
+        // defaultReceiveMap keys by the raw setter zone (receive[R] = setter@R), not the old index.
+        expect(defaultReceiveMap(RotationSystemEnum.FIVE_ONE)).toEqual(defaultBaseConfig(RotationSystemEnum.FIVE_ONE).receive);
+    });
+    it('every system: receive[R] hides the setter at zone R (raw), never at ROTATION_TO_SETTER_ZONE[R]', () => {
+        for (const system of Object.values(RotationSystemEnum)) {
+            if (system === RotationSystemEnum.SIX_ZERO)
+                continue; // 6-0 has no designated setter
+            const map = defaultReceiveMap(system);
+            for (const z of [2, 3, 5, 6]) { // the rotations where raw and the old index convention diverge
+                expect({ system, z, passes: map[String(z)]?.[String(z)] }).toEqual({ system, z, passes: false });
+            }
+        }
+    });
+});
+describe('defaultBaseConfig base-config legality', () => {
+    it('has zero SERVE/RECEIVE overlap violations for every rotation system', () => {
+        for (const system of Object.values(RotationSystemEnum)) {
+            expect({ system, violations: baseConfigViolations(defaultBaseConfig(system)) }).toEqual({ system, violations: [] });
+        }
+    });
+});
+// Regression (rush6@ tournament report, 2026-08-21): a partial RECEIVE config (some zones stored, one left unset)
+// reads "out of rotation even in base" ONLY when the editor fills the unset zone from a coarse flat grid (all
+// back-row zones at depth 6.5), which lands on a stored DEEP neighbour. Filling from the sim's per-rotation default
+// (what the editor's coordOf now does, matching what the sim always did) keeps it legal.
+describe('unset RECEIVE zone fallback (editor gap fill)', () => {
+    // The reported user's real rotation-2 RECEIVE: zone 3 sits abnormally deep at d 6.5; zone 6 is unset.
+    const partialRot2 = {
+        1: { d: 6.4, r: 3.15 }, 2: { d: 2.75, r: 1.65 }, 3: { d: 6.5, r: -2.65 }, 4: { d: 2.75, r: -2.75 }, 5: { d: 2.8, r: -3.05 }
+    };
+    const FLAT_GRID_ZONE6 = { d: 6.5, r: 0 }; // the editor's OLD blank-slate default for a back-row zone
+    const SIM_DEFAULT_ZONE6 = defaultBaseConfig(RotationSystemEnum.FIVE_ONE).coords.RECEIVE['2']['6']; // the fix's fallback
+    const violationsWithZone6 = (zone6) => baseConfigViolations({ coords: { RECEIVE: { 2: { ...partialRot2, 6: zone6 } } } });
+    it('collides (zones 3,6) when the gap is filled from the flat grid - the bug', () => {
+        expect(violationsWithZone6(FLAT_GRID_ZONE6).map(v => v.zones)).toEqual([[3, 6]]);
+    });
+    it('stays legal when the gap is filled from the sim per-rotation default - the fix', () => {
+        expect(violationsWithZone6(SIM_DEFAULT_ZONE6)).toEqual([]);
+    });
+});
 // The trajectory-set default desired-contact (owner D9, 2026-08-12): a near-net hitting point in each attacker's
 // lane, NOT the old set-to-the-standing-dot location. Front row contacts sit ~0.5 m off the net; back row on the
 // ~1.8 m pipe line; the lateral is the ATTACK-dot's r clamped inside the antenna (|r| <= 4.3).

package/package.json

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