volleyballsimtypes 0.0.504 → 0.0.505

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

@@ -1,4 +1,4 @@
-import { BoxScore, DataProps, DeclineStatus, Division as _Division, League as _League, Match as _Match, MatchSet as _MatchSet, Player as _Player, PlayerPosition, Qualifier as _Qualifier, QualifierMatch as _QualifierMatch, Rally as _Rally, RallyEvent as _RallyEvent, PointBreakdown, RallyMetrics, Season as _Season, Standing as _Standing, Team as _Team, Tournament as _Tournament, TournamentMatch as _TournamentMatch, National as _National, NationalMatch as _NationalMatch, Country as _Country, BlockingAssignment, CourtPosition, ConditionLogic, EnergyBand, MatchForfeitType, PerformanceStats, PinchCondition, RotationSystemEnum, SubBackMode, SubBand } from '../service';
+import { BaseConfig, BoxScore, DataProps, DeclineStatus, Division as _Division, League as _League, Match as _Match, MatchSet as _MatchSet, Player as _Player, PlayerPosition, Qualifier as _Qualifier, QualifierMatch as _QualifierMatch, Rally as _Rally, RallyEvent as _RallyEvent, PointBreakdown, RallyMetrics, Season as _Season, Standing as _Standing, Team as _Team, Tournament as _Tournament, TournamentMatch as _TournamentMatch, National as _National, NationalMatch as _NationalMatch, Country as _Country, BlockingAssignment, CourtPosition, ConditionLogic, EnergyBand, MatchForfeitType, PerformanceStats, PinchCondition, RotationSystemEnum, SubBackMode, SubBand } from '../service';
 export * from './tactics-player-refs';
 export type Rally = DataProps<_Rally> & {
     homePlayerPosition: PlayerPosition[];
@@ -140,6 +140,7 @@ export interface Tactics {
     systemSets?: ApiSystemSet[];
     offensivePreferenceSets?: ApiOffensivePreference[][];
     serveAttackShares?: Record<string, number>;
+    basePositions?: BaseConfig;
     blockingPreferences: ApiBlockingPreference[];
     blockingPreferenceSets?: ApiBlockingPreference[][];
     replaceKnockedImmediately?: Record<string, boolean>;

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

@@ -1,7 +1,7 @@
 import * as Sequelize from 'sequelize';
 import { Model, Optional } from 'sequelize';
 import { PlayerId, TeamId, TeamModel } from '.';
-import { BlockingAssignment, ConditionLogic, CourtPosition, EnergyBand, PinchCondition, RotationSystemEnum, SubBackMode, SubBand, SubMode } from '../../service';
+import { BaseConfig, BlockingAssignment, ConditionLogic, CourtPosition, EnergyBand, PinchCondition, RotationSystemEnum, SubBackMode, SubBand, SubMode } from '../../service';
 export interface TacticsLineupAttributes {
     [CourtPosition.LIBERO_ZONE]?: PlayerId;
     [CourtPosition.LEFT_BACK]: PlayerId;
@@ -82,10 +82,11 @@ export interface TacticsAttributes {
     libero_injury?: LiberoInjuryAttributes;
     blocking_preferences: BlockingPreferenceAttributes[];
     blocking_preference_sets?: BlockingPreferenceAttributes[][];
+    base_positions?: BaseConfig;
 }
 export type TacticsPk = 'team_id';
 export type TacticsId = TacticsModel[TacticsPk];
-export type TacticsOptionalAttributes = 'lineup' | 'libero_replacements' | 'receive_rotation_offset' | 'designated_subs' | 'substitution_band' | 'second_libero' | 'libero_sub' | 'libero_replacement_sets' | 'rotation_system' | 'designated_setters' | 'offensive_preferences' | 'system_sets' | 'offensive_preference_sets' | 'serve_attack_shares' | 'replace_knocked_immediately' | 'injury_replacements' | 'libero_injury' | 'blocking_preferences' | 'blocking_preference_sets';
+export type TacticsOptionalAttributes = 'lineup' | 'libero_replacements' | 'receive_rotation_offset' | 'designated_subs' | 'substitution_band' | 'second_libero' | 'libero_sub' | 'libero_replacement_sets' | 'rotation_system' | 'designated_setters' | 'offensive_preferences' | 'system_sets' | 'offensive_preference_sets' | 'serve_attack_shares' | 'replace_knocked_immediately' | 'injury_replacements' | 'libero_injury' | 'blocking_preferences' | 'blocking_preference_sets' | 'base_positions';
 export type TacticsCreationAttributes = Optional<TacticsAttributes, TacticsOptionalAttributes>;
 export declare class TacticsModel extends Model<TacticsAttributes, TacticsCreationAttributes> implements TacticsAttributes {
     team_id: string;
@@ -108,6 +109,7 @@ export declare class TacticsModel extends Model<TacticsAttributes, TacticsCreati
     libero_injury?: LiberoInjuryAttributes;
     blocking_preferences: BlockingPreferenceAttributes[];
     blocking_preference_sets?: BlockingPreferenceAttributes[][];
+    base_positions?: BaseConfig;
     team: TeamModel;
     getTeam: Sequelize.BelongsToGetAssociationMixin<TeamModel>;
     setTeam: Sequelize.BelongsToSetAssociationMixin<TeamModel, TeamId>;

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

@@ -100,6 +100,10 @@ class TacticsModel extends sequelize_1.Model {
             blocking_preference_sets: {
                 type: sequelize_1.DataTypes.JSONB,
                 allowNull: true
+            },
+            base_positions: {
+                type: sequelize_1.DataTypes.JSONB,
+                allowNull: true
             }
         }, {
             sequelize,

package/dist/cjs/src/data/transformers/rally-event-injury.test.js

@@ -41,7 +41,7 @@ const rally_event_1 = require("./rally-event");
             score: 62.5,
             target: 4,
             failure: service_1.SpikeFailureEnum.NO_FAILURE,
-            type: service_1.SpikeTypeEnum.CROSS_SHOT,
+            type: service_1.SpikeTypeEnum.SPIKE,
             ...(incident != null ? { incident } : {})
         });
     }

package/dist/cjs/src/data/transformers/rally-event-positional.test.js

@@ -14,7 +14,7 @@ const rally_event_1 = require("./rally-event");
             score: 60,
             target: 4,
             failure: service_1.SpikeFailureEnum.NO_FAILURE,
-            type: service_1.SpikeTypeEnum.CROSS_SHOT,
+            type: service_1.SpikeTypeEnum.SPIKE,
             contact: { x: 1.234, y: -0.5 },
             landing: { x: -2.5, y: 6.789 },
             speed: 92.456
@@ -43,7 +43,7 @@ const rally_event_1 = require("./rally-event");
         (0, globals_1.expect)(decoded.digQuality).toBe(service_1.DigQualityEnum.MEDIOCRE);
     });
     (0, globals_1.it)('omits the positional keys when absent, and a legacy event decodes them as undefined', () => {
-        const spike = service_1.Spike.create({ playerId, score: 60, target: 4, failure: service_1.SpikeFailureEnum.NO_FAILURE, type: service_1.SpikeTypeEnum.CROSS_SHOT });
+        const spike = service_1.Spike.create({ playerId, score: 60, target: 4, failure: service_1.SpikeFailureEnum.NO_FAILURE, type: service_1.SpikeTypeEnum.SPIKE });
         const compact = (0, rally_event_1.transformToCompact)(spike, playerIndex);
         (0, globals_1.expect)('c' in compact).toBe(false);
         (0, globals_1.expect)('v' in compact).toBe(false);
@@ -53,4 +53,12 @@ const rally_event_1 = require("./rally-event");
         (0, globals_1.expect)(decoded.speed).toBeUndefined();
         (0, globals_1.expect)(decoded.digQuality).toBeUndefined();
     });
+    (0, globals_1.it)('collapses legacy LINE_SHOT(1)/REVERSE_CROSS(2) to SPIKE(0) on decode (owner 2026-08-03)', () => {
+        // A zone-engine match persisted before the collapse carries type 1 or 2 in its jsonb; decode heals them to
+        // SPIKE so the match still opens. TIP(3) and up are untouched.
+        const base = (0, rally_event_1.transformToCompact)(service_1.Spike.create({ playerId, score: 60, target: 4, failure: service_1.SpikeFailureEnum.NO_FAILURE, type: service_1.SpikeTypeEnum.SPIKE }), playerIndex);
+        (0, globals_1.expect)((0, rally_event_1.transformToSpike)({ ...base, t: 1 }, roster).type).toBe(service_1.SpikeTypeEnum.SPIKE);
+        (0, globals_1.expect)((0, rally_event_1.transformToSpike)({ ...base, t: 2 }, roster).type).toBe(service_1.SpikeTypeEnum.SPIKE);
+        (0, globals_1.expect)((0, rally_event_1.transformToSpike)({ ...base, t: 3 }, roster).type).toBe(service_1.SpikeTypeEnum.TIP);
+    });
 });

package/dist/cjs/src/data/transformers/rally-event.js

@@ -138,7 +138,9 @@ function transformToSet(event, roster) {
 function transformToSpike(event, roster) {
     return service_1.Spike.create({
         failure: event.f,
-        type: event.t,
+        // Legacy LINE_SHOT(1)/REVERSE_CROSS(2) collapse to SPIKE(0) (owner 2026-08-03): direction is redundant with
+        // the stored contact+landing coords. Maps old zone-engine matches so they keep decoding; new events emit 0/3-6.
+        type: event.t === 1 || event.t === 2 ? 0 : event.t,
         playerId: roster[event.p],
         target: event.a,
         score: event.s,

package/dist/cjs/src/data/transformers/rally.test.js

@@ -19,7 +19,7 @@ const rally_1 = require("./rally");
         service_1.Serve.create({ playerId: pA, target: 6, score: 55, failure: service_1.ServeFailureEnum.NO_FAILURE, type: service_1.ServeTypeEnum.JUMP_TOPSPIN }),
         service_1.Reception.create({ playerId: pB, target: 5, score: 50, failure: service_1.ReceptionFailureEnum.NO_FAILURE, type: service_1.ReceptionTypeEnum.DIG }),
         service_1.Set.create({ playerId: pC, target: 3, score: 48, failure: service_1.SetFailureEnum.NO_FAILURE, type: service_1.SetTypeEnum.OVERHAND, tempo: service_1.SetTempoEnum.FIRST }),
-        service_1.Spike.create({ playerId: pA, target: 4, score: 62.5, failure: service_1.SpikeFailureEnum.NO_FAILURE, type: service_1.SpikeTypeEnum.CROSS_SHOT }),
+        service_1.Spike.create({ playerId: pA, target: 4, score: 62.5, failure: service_1.SpikeFailureEnum.NO_FAILURE, type: service_1.SpikeTypeEnum.SPIKE }),
         service_1.Block.create({ playerId: pB, blockers: [pB, pC], target: 8, score: 48, failure: service_1.BlockFailureEnum.NO_FAILURE, type: service_1.BlockTypeEnum.DOUBLE }),
         service_1.FreeBall.create({ playerId: pC, target: 6, score: 45, failure: service_1.FreeBallFailureEnum.NO_FAILURE, type: service_1.FreeBallTypeEnum.OVER })
     ];
@@ -49,7 +49,7 @@ const rally_1 = require("./rally");
         (0, globals_1.expect)(rec.type).toBe(service_1.ReceptionTypeEnum.DIG);
         (0, globals_1.expect)(set.type).toBe(service_1.SetTypeEnum.OVERHAND);
         (0, globals_1.expect)(set.tempo).toBe(service_1.SetTempoEnum.FIRST);
-        (0, globals_1.expect)(spike.type).toBe(service_1.SpikeTypeEnum.CROSS_SHOT);
+        (0, globals_1.expect)(spike.type).toBe(service_1.SpikeTypeEnum.SPIKE);
         (0, globals_1.expect)(spike.score).toBe(62.5);
         (0, globals_1.expect)(block.type).toBe(service_1.BlockTypeEnum.DOUBLE);
         (0, globals_1.expect)(block.blockers).toEqual([pB, pC]);

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

@@ -86,6 +86,7 @@ function transformToAttributes(tactics, teamId) {
             tempos: p.tempos
         }))),
         serve_attack_shares: tactics.serveAttackShares ?? {},
+        base_positions: tactics.basePositions,
         blocking_preferences: tactics.blockingPreferences.map(p => ({ rotation: p.rotation, targets: p.targets })),
         blocking_preference_sets: tactics.blockingPreferenceSets?.map(prefs => prefs.map(p => ({ rotation: p.rotation, targets: p.targets }))),
         replace_knocked_immediately: tactics.replaceKnockedImmediately,
@@ -207,6 +208,7 @@ function transformToObject(model, roster) {
             }
             return healed;
         })(),
+        basePositions: model.base_positions ?? undefined,
         blockingPreferences: (model.blocking_preferences ?? []).map(p => ({ rotation: p.rotation, targets: p.targets })),
         blockingPreferenceSets: model.blocking_preference_sets?.map(prefs => prefs.map(p => ({ rotation: p.rotation, targets: p.targets }))),
         // LENIENT: keep only boolean entries keyed by a court starter or, when a second libero exists, the starting
@@ -367,6 +369,7 @@ function tacticsColumnsToApiDto(model) {
             }
             return Object.keys(healed).length > 0 ? healed : undefined;
         })(),
+        basePositions: model.base_positions ?? undefined,
         blockingPreferences: model.blocking_preferences,
         blockingPreferenceSets: model.blocking_preference_sets,
         // Same stale-data policy as the heals below: only boolean entries keyed by a court starter or, when a second
@@ -475,6 +478,7 @@ function apiTacticsConfigToAttributes(config, teamId) {
         system_sets: config.systemSets,
         offensive_preference_sets: config.offensivePreferenceSets,
         serve_attack_shares: config.serveAttackShares ?? {},
+        base_positions: config.basePositions,
         blocking_preferences: config.blockingPreferences ?? [],
         blocking_preference_sets: config.blockingPreferenceSets,
         replace_knocked_immediately: config.replaceKnockedImmediately,

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

@@ -227,6 +227,30 @@ function makeTactics(designatedSubs) {
         const back = (0, tactics_1.transformToTactics)(attrs, roster);
         (0, globals_1.expect)(back.serveAttackShares).toEqual({});
     });
+    (0, globals_1.it)('round-trips base positions (coords + reception participation)', () => {
+        const config = {
+            coords: { RECEIVE: { 1: { 5: { d: 5.5, r: -3 }, 6: { d: 6.5, r: 0 } } }, DEFENCE: { 3: { 2: { d: 0.9, r: 3 } } } },
+            receive: { 1: { 5: true, 2: false }, 4: { 6: true } }
+        };
+        const withBases = service_1.Tactics.create({
+            lineup: { 4: p4, 3: p3, 2: p2, 5: p5, 6: p6, 1: p1, bench: [] },
+            liberoReplacements: [],
+            basePositions: config
+        });
+        const attrs = (0, tactics_1.transformFromTactics)(withBases, 'team-1');
+        (0, globals_1.expect)(attrs.base_positions).toEqual(config);
+        const back = (0, tactics_1.transformToTactics)(attrs, roster);
+        (0, globals_1.expect)(back.basePositions).toEqual(config);
+    });
+    (0, globals_1.it)('leaves basePositions undefined when the column is absent', () => {
+        const attrs = (0, tactics_1.transformFromTactics)(service_1.Tactics.create({
+            lineup: { 4: p4, 3: p3, 2: p2, 5: p5, 6: p6, 1: p1, bench: [] },
+            liberoReplacements: []
+        }), 'team-1');
+        (0, globals_1.expect)(attrs.base_positions).toBeUndefined();
+        const back = (0, tactics_1.transformToTactics)(attrs, roster);
+        (0, globals_1.expect)(back.basePositions).toBeUndefined();
+    });
     (0, globals_1.it)('round-trips a per-starter tempos map on offensive preferences', () => {
         const withTempos = service_1.Tactics.create({
             lineup: { 4: p4, 3: p3, 2: p2, 5: p5, 6: p6, 1: p1, bench: [] },

package/dist/cjs/src/service/event/schemas/spike.z.js

@@ -5,7 +5,9 @@ const zod_1 = require("zod");
 const player_1 = require("../../player");
 const incident_z_1 = require("./incident.z");
 const positional_z_1 = require("./positional.z");
-const spikeTypeValues = [0, 1, 2, 3, 4, 5, 6];
+// SPIKE(0), TIP(3), DOWN_BALL(4), OVERHAND(5), TOOL(6). 1/2 (legacy LINE_SHOT/REVERSE_CROSS) are retired; the
+// codec (transformToSpike) maps them to 0 before this validates, so they never reach here.
+const spikeTypeValues = [0, 3, 4, 5, 6];
 const spikeFailureValues = [0, 1, 2, 3, 4];
 const courtTargetValues = Array.from({ length: 13 }, (_, i) => i);
 exports.SpikeInputSchema = zod_1.z.object({

package/dist/cjs/src/service/event/spike.d.ts

@@ -1,14 +1,12 @@
 import { InPlayEvent } from './in-play-event';
 export declare enum SpikeTypeEnum {
-    CROSS_SHOT = 0,
-    LINE_SHOT = 1,
-    REVERSE_CROSS = 2,
+    SPIKE = 0,
     TIP = 3,
     DOWN_BALL = 4,
     OVERHAND = 5,
     TOOL = 6
 }
-export type SpikeType = SpikeTypeEnum.CROSS_SHOT | SpikeTypeEnum.LINE_SHOT | SpikeTypeEnum.REVERSE_CROSS | SpikeTypeEnum.TIP | SpikeTypeEnum.DOWN_BALL | SpikeTypeEnum.OVERHAND | SpikeTypeEnum.TOOL;
+export type SpikeType = SpikeTypeEnum.SPIKE | SpikeTypeEnum.TIP | SpikeTypeEnum.DOWN_BALL | SpikeTypeEnum.OVERHAND | SpikeTypeEnum.TOOL;
 export declare enum SpikeFailureEnum {
     NO_FAILURE = 0,
     FAULT = 1,

package/dist/cjs/src/service/event/spike.js

@@ -6,9 +6,11 @@ const in_play_event_1 = require("./in-play-event");
 const spike_z_1 = require("./schemas/spike.z");
 var SpikeTypeEnum;
 (function (SpikeTypeEnum) {
-    SpikeTypeEnum[SpikeTypeEnum["CROSS_SHOT"] = 0] = "CROSS_SHOT";
-    SpikeTypeEnum[SpikeTypeEnum["LINE_SHOT"] = 1] = "LINE_SHOT";
-    SpikeTypeEnum[SpikeTypeEnum["REVERSE_CROSS"] = 2] = "REVERSE_CROSS";
+    // A hard swing (owner 2026-08-03). The cross / line / reverse DIRECTION is not stored: it is fully derivable
+    // from the persisted contact + landing coordinates, so a single SPIKE value replaces the old CROSS_SHOT(0) /
+    // LINE_SHOT(1) / REVERSE_CROSS(2). 1 and 2 are retired (left as gaps); the codec maps any legacy 1/2 back to
+    // SPIKE(0), so existing (zone-engine) matches keep decoding.
+    SpikeTypeEnum[SpikeTypeEnum["SPIKE"] = 0] = "SPIKE";
     SpikeTypeEnum[SpikeTypeEnum["TIP"] = 3] = "TIP";
     SpikeTypeEnum[SpikeTypeEnum["DOWN_BALL"] = 4] = "DOWN_BALL";
     SpikeTypeEnum[SpikeTypeEnum["OVERHAND"] = 5] = "OVERHAND";

package/dist/cjs/src/service/team/base-config.d.ts

@@ -0,0 +1,10 @@
+export type BaseFormation = 'SERVE' | 'RECEIVE' | 'DEFENCE' | 'DEF_L' | 'DEF_M' | 'DEF_R' | 'ATTACK';
+export declare const BASE_FORMATIONS: readonly BaseFormation[];
+export interface BaseCoord {
+    readonly d: number;
+    readonly r: number;
+}
+export interface BaseConfig {
+    readonly coords: Record<string, Record<string, Record<string, BaseCoord>>>;
+    readonly receive: Record<string, Record<string, boolean>>;
+}

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

@@ -0,0 +1,14 @@
+"use strict";
+// Per-team base-position configuration (owner 2026-08-03). Generalises the sim's hardcoded 5-1 preset into a
+// system-agnostic, per-team shape: for each formation, rotation and rotational ZONE, where that zone's player
+// stands, plus (serve-receive only) whether that zone's player passes the serve. Authored in the UI base editor
+// (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).
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BASE_FORMATIONS = void 0;
+exports.BASE_FORMATIONS = ['SERVE', 'RECEIVE', 'DEFENCE', 'DEF_L', 'DEF_M', 'DEF_R', 'ATTACK'];

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

@@ -2,6 +2,7 @@ export * from './team';
 export * from './team-generator';
 export * from './formation';
 export * from './tactics';
+export * from './base-config';
 export * from './team-name';
 export * from './energy-band';
 export * from './pinch-condition';

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

@@ -18,6 +18,7 @@ __exportStar(require("./team"), exports);
 __exportStar(require("./team-generator"), exports);
 __exportStar(require("./formation"), exports);
 __exportStar(require("./tactics"), exports);
+__exportStar(require("./base-config"), exports);
 __exportStar(require("./team-name"), exports);
 __exportStar(require("./energy-band"), exports);
 __exportStar(require("./pinch-condition"), exports);

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

@@ -288,6 +288,13 @@ export declare const TacticsInputSchema: z.ZodObject<{
         rotation: z.ZodNumber;
         targets: z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodEnum<typeof RoleEnum> & z.ZodType<RoleEnum.SETTER | RoleEnum.OUTSIDE_HITTER | RoleEnum.OPPOSITE_HITTER | RoleEnum.MIDDLE_BLOCKER, RoleEnum, z.core.$ZodTypeInternals<RoleEnum.SETTER | RoleEnum.OUTSIDE_HITTER | RoleEnum.OPPOSITE_HITTER | RoleEnum.MIDDLE_BLOCKER, RoleEnum>>, z.ZodLiteral<"NO_BLOCK">]>>;
     }, z.core.$strip>>>>;
+    basePositions: z.ZodOptional<z.ZodObject<{
+        coords: z.ZodRecord<z.ZodString, z.ZodRecord<z.ZodString, z.ZodRecord<z.ZodString, z.ZodObject<{
+            d: z.ZodNumber;
+            r: z.ZodNumber;
+        }, z.core.$strip>>>>;
+        receive: z.ZodRecord<z.ZodString, z.ZodRecord<z.ZodString, z.ZodBoolean>>;
+    }, z.core.$strip>>;
     replaceKnockedImmediately: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodBoolean>>;
     injuryReplacements: z.ZodDefault<z.ZodArray<z.ZodObject<{
         starter: z.ZodCustom<Player, Player>;

package/dist/cjs/src/service/team/schemas/tactics.z.js

@@ -77,6 +77,15 @@ const systemSetSchema = zod_1.z.object({
     rotationSystem: zod_1.z.nativeEnum(rotation_system_1.RotationSystemEnum),
     designatedSetters: zod_1.z.array(playerInstanceSchema)
 });
+// Base positions (owner 2026-08-03): coords[formation][rotation][zone] -> {d,r} + receive[rotation][zone] -> bool.
+// jsonb keys are strings; the coordinate + boolean leaves are validated. Structural key ranges (formation names,
+// rotations 1-6, zones 1-6) are trusted from the UI editor / preset compiler, which write the engine rotation
+// convention. Out-of-court coordinates are allowed, so d/r are not range-clamped here.
+const baseCoordSchema = zod_1.z.object({ d: zod_1.z.number().finite(), r: zod_1.z.number().finite() });
+const baseConfigSchema = zod_1.z.object({
+    coords: zod_1.z.record(zod_1.z.string(), zod_1.z.record(zod_1.z.string(), zod_1.z.record(zod_1.z.string(), baseCoordSchema))),
+    receive: zod_1.z.record(zod_1.z.string(), zod_1.z.record(zod_1.z.string(), zod_1.z.boolean()))
+});
 exports.TacticsInputSchema = zod_1.z.object({
     lineup: lineupSchema,
     liberoReplacements: zod_1.z.array(playerInstanceSchema),
@@ -107,6 +116,8 @@ exports.TacticsInputSchema = zod_1.z.object({
     // Blocking preferences (dedicated blocking). Defaults keep every existing Tactics.create({...}) call valid.
     blockingPreferences: zod_1.z.array(blockingPreferenceSchema).default([]),
     blockingPreferenceSets: zod_1.z.array(zod_1.z.array(blockingPreferenceSchema)).max(5).optional(),
+    // Base positions (owner 2026-08-03). Optional -> the sim falls back to the default preset for the system.
+    basePositions: baseConfigSchema.optional(),
     // Injuries. Defaults keep every existing Tactics.create({...}) call valid. replaceKnockedImmediately is
     // PER STARTER (owner order 2026-07-05): keyed by starter id, missing key = ON; keys validated against the
     // lineup in the superRefine below. injuryReplacements is the per-starter explicit replacement mapping

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

@@ -296,6 +296,13 @@ export declare const TeamInputSchema: z.ZodObject<{
             rotation: z.ZodNumber;
             targets: z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodEnum<typeof import("../../player").RoleEnum> & z.ZodType<import("../../player").RoleEnum.SETTER | import("../../player").RoleEnum.OUTSIDE_HITTER | import("../../player").RoleEnum.OPPOSITE_HITTER | import("../../player").RoleEnum.MIDDLE_BLOCKER, import("../../player").RoleEnum, z.core.$ZodTypeInternals<import("../../player").RoleEnum.SETTER | import("../../player").RoleEnum.OUTSIDE_HITTER | import("../../player").RoleEnum.OPPOSITE_HITTER | import("../../player").RoleEnum.MIDDLE_BLOCKER, import("../../player").RoleEnum>>, z.ZodLiteral<"NO_BLOCK">]>>;
         }, z.core.$strip>>>>;
+        basePositions: z.ZodOptional<z.ZodObject<{
+            coords: z.ZodRecord<z.ZodString, z.ZodRecord<z.ZodString, z.ZodRecord<z.ZodString, z.ZodObject<{
+                d: z.ZodNumber;
+                r: z.ZodNumber;
+            }, z.core.$strip>>>>;
+            receive: z.ZodRecord<z.ZodString, z.ZodRecord<z.ZodString, z.ZodBoolean>>;
+        }, z.core.$strip>>;
         replaceKnockedImmediately: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodBoolean>>;
         injuryReplacements: z.ZodDefault<z.ZodArray<z.ZodObject<{
             starter: z.ZodCustom<Player, Player>;

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

@@ -8,6 +8,7 @@ import { OffensivePreference } from './offensive-preference';
 import { BlockingPreference } from './blocking-preference';
 import { InjuryReplacement } from './injury-replacement';
 import { LiberoInjuryConfig } from './libero-injury';
+import { BaseConfig } from './base-config';
 export interface StartingLineup {
     readonly [CourtPosition.LEFT_FRONT]: Player;
     readonly [CourtPosition.MIDDLE_FRONT]: Player;
@@ -42,6 +43,7 @@ export interface TacticsOpts {
     readonly liberoInjury?: LiberoInjuryConfig;
     readonly blockingPreferences: BlockingPreference[];
     readonly blockingPreferenceSets?: BlockingPreference[][];
+    readonly basePositions?: BaseConfig;
 }
 export declare class Tactics {
     readonly lineup: StartingLineup;
@@ -63,6 +65,7 @@ export declare class Tactics {
     readonly liberoInjury?: LiberoInjuryConfig;
     readonly blockingPreferences: BlockingPreference[];
     readonly blockingPreferenceSets?: BlockingPreference[][];
+    readonly basePositions?: BaseConfig;
     static create(input: unknown): Tactics;
     private constructor();
     findPlayerInLineup(id: string): CourtPosition | undefined;

package/dist/cjs/src/service/team/tactics.js

@@ -18,7 +18,7 @@ class Tactics {
         }
         return new Tactics(result.data);
     }
-    constructor({ lineup, liberoReplacements, receiveRotationOffset = false, designatedSubs = [], substitutionBand = energy_band_1.EnergyBand.TIRED, secondLibero, liberoSub, liberoReplacementSets, rotationSystem = rotation_system_1.RotationSystemEnum.SIX_ZERO, designatedSetters = [], offensivePreferences = [], serveAttackShares = {}, systemSets, offensivePreferenceSets, replaceKnockedImmediately = {}, injuryReplacements = [], liberoInjury, blockingPreferences = [], blockingPreferenceSets }) {
+    constructor({ lineup, liberoReplacements, receiveRotationOffset = false, designatedSubs = [], substitutionBand = energy_band_1.EnergyBand.TIRED, secondLibero, liberoSub, liberoReplacementSets, rotationSystem = rotation_system_1.RotationSystemEnum.SIX_ZERO, designatedSetters = [], offensivePreferences = [], serveAttackShares = {}, systemSets, offensivePreferenceSets, replaceKnockedImmediately = {}, injuryReplacements = [], liberoInjury, blockingPreferences = [], blockingPreferenceSets, basePositions }) {
         this.lineup = lineup;
         this.liberoReplacements = liberoReplacements;
         this.receiveRotationOffset = receiveRotationOffset;
@@ -38,6 +38,7 @@ class Tactics {
         this.liberoInjury = liberoInjury;
         this.blockingPreferences = blockingPreferences;
         this.blockingPreferenceSets = blockingPreferenceSets;
+        this.basePositions = basePositions;
     }
     findPlayerInLineup(id) {
         if (this.lineup.bench.some(p => p.id === id))

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

@@ -1,4 +1,4 @@
-import { BoxScore, DataProps, DeclineStatus, Division as _Division, League as _League, Match as _Match, MatchSet as _MatchSet, Player as _Player, PlayerPosition, Qualifier as _Qualifier, QualifierMatch as _QualifierMatch, Rally as _Rally, RallyEvent as _RallyEvent, PointBreakdown, RallyMetrics, Season as _Season, Standing as _Standing, Team as _Team, Tournament as _Tournament, TournamentMatch as _TournamentMatch, National as _National, NationalMatch as _NationalMatch, Country as _Country, BlockingAssignment, CourtPosition, ConditionLogic, EnergyBand, MatchForfeitType, PerformanceStats, PinchCondition, RotationSystemEnum, SubBackMode, SubBand } from '../service';
+import { BaseConfig, BoxScore, DataProps, DeclineStatus, Division as _Division, League as _League, Match as _Match, MatchSet as _MatchSet, Player as _Player, PlayerPosition, Qualifier as _Qualifier, QualifierMatch as _QualifierMatch, Rally as _Rally, RallyEvent as _RallyEvent, PointBreakdown, RallyMetrics, Season as _Season, Standing as _Standing, Team as _Team, Tournament as _Tournament, TournamentMatch as _TournamentMatch, National as _National, NationalMatch as _NationalMatch, Country as _Country, BlockingAssignment, CourtPosition, ConditionLogic, EnergyBand, MatchForfeitType, PerformanceStats, PinchCondition, RotationSystemEnum, SubBackMode, SubBand } from '../service';
 export * from './tactics-player-refs';
 export type Rally = DataProps<_Rally> & {
     homePlayerPosition: PlayerPosition[];
@@ -140,6 +140,7 @@ export interface Tactics {
     systemSets?: ApiSystemSet[];
     offensivePreferenceSets?: ApiOffensivePreference[][];
     serveAttackShares?: Record<string, number>;
+    basePositions?: BaseConfig;
     blockingPreferences: ApiBlockingPreference[];
     blockingPreferenceSets?: ApiBlockingPreference[][];
     replaceKnockedImmediately?: Record<string, boolean>;

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

@@ -1,7 +1,7 @@
 import * as Sequelize from 'sequelize';
 import { Model, Optional } from 'sequelize';
 import { PlayerId, TeamId, TeamModel } from '.';
-import { BlockingAssignment, ConditionLogic, CourtPosition, EnergyBand, PinchCondition, RotationSystemEnum, SubBackMode, SubBand, SubMode } from '../../service';
+import { BaseConfig, BlockingAssignment, ConditionLogic, CourtPosition, EnergyBand, PinchCondition, RotationSystemEnum, SubBackMode, SubBand, SubMode } from '../../service';
 export interface TacticsLineupAttributes {
     [CourtPosition.LIBERO_ZONE]?: PlayerId;
     [CourtPosition.LEFT_BACK]: PlayerId;
@@ -82,10 +82,11 @@ export interface TacticsAttributes {
     libero_injury?: LiberoInjuryAttributes;
     blocking_preferences: BlockingPreferenceAttributes[];
     blocking_preference_sets?: BlockingPreferenceAttributes[][];
+    base_positions?: BaseConfig;
 }
 export type TacticsPk = 'team_id';
 export type TacticsId = TacticsModel[TacticsPk];
-export type TacticsOptionalAttributes = 'lineup' | 'libero_replacements' | 'receive_rotation_offset' | 'designated_subs' | 'substitution_band' | 'second_libero' | 'libero_sub' | 'libero_replacement_sets' | 'rotation_system' | 'designated_setters' | 'offensive_preferences' | 'system_sets' | 'offensive_preference_sets' | 'serve_attack_shares' | 'replace_knocked_immediately' | 'injury_replacements' | 'libero_injury' | 'blocking_preferences' | 'blocking_preference_sets';
+export type TacticsOptionalAttributes = 'lineup' | 'libero_replacements' | 'receive_rotation_offset' | 'designated_subs' | 'substitution_band' | 'second_libero' | 'libero_sub' | 'libero_replacement_sets' | 'rotation_system' | 'designated_setters' | 'offensive_preferences' | 'system_sets' | 'offensive_preference_sets' | 'serve_attack_shares' | 'replace_knocked_immediately' | 'injury_replacements' | 'libero_injury' | 'blocking_preferences' | 'blocking_preference_sets' | 'base_positions';
 export type TacticsCreationAttributes = Optional<TacticsAttributes, TacticsOptionalAttributes>;
 export declare class TacticsModel extends Model<TacticsAttributes, TacticsCreationAttributes> implements TacticsAttributes {
     team_id: string;
@@ -108,6 +109,7 @@ export declare class TacticsModel extends Model<TacticsAttributes, TacticsCreati
     libero_injury?: LiberoInjuryAttributes;
     blocking_preferences: BlockingPreferenceAttributes[];
     blocking_preference_sets?: BlockingPreferenceAttributes[][];
+    base_positions?: BaseConfig;
     team: TeamModel;
     getTeam: Sequelize.BelongsToGetAssociationMixin<TeamModel>;
     setTeam: Sequelize.BelongsToSetAssociationMixin<TeamModel, TeamId>;

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

@@ -97,6 +97,10 @@ export class TacticsModel extends Model {
             blocking_preference_sets: {
                 type: DataTypes.JSONB,
                 allowNull: true
+            },
+            base_positions: {
+                type: DataTypes.JSONB,
+                allowNull: true
             }
         }, {
             sequelize,

package/dist/esm/src/data/transformers/rally-event-injury.test.js

@@ -39,7 +39,7 @@ describe('rally-event compact round trip — incident marker on the causing even
             score: 62.5,
             target: 4,
             failure: SpikeFailureEnum.NO_FAILURE,
-            type: SpikeTypeEnum.CROSS_SHOT,
+            type: SpikeTypeEnum.SPIKE,
             ...(incident != null ? { incident } : {})
         });
     }

package/dist/esm/src/data/transformers/rally-event-positional.test.js

@@ -12,7 +12,7 @@ describe('rally-event compact round trip -- positional fields (coords / speed /
             score: 60,
             target: 4,
             failure: SpikeFailureEnum.NO_FAILURE,
-            type: SpikeTypeEnum.CROSS_SHOT,
+            type: SpikeTypeEnum.SPIKE,
             contact: { x: 1.234, y: -0.5 },
             landing: { x: -2.5, y: 6.789 },
             speed: 92.456
@@ -41,7 +41,7 @@ describe('rally-event compact round trip -- positional fields (coords / speed /
         expect(decoded.digQuality).toBe(DigQualityEnum.MEDIOCRE);
     });
     it('omits the positional keys when absent, and a legacy event decodes them as undefined', () => {
-        const spike = Spike.create({ playerId, score: 60, target: 4, failure: SpikeFailureEnum.NO_FAILURE, type: SpikeTypeEnum.CROSS_SHOT });
+        const spike = Spike.create({ playerId, score: 60, target: 4, failure: SpikeFailureEnum.NO_FAILURE, type: SpikeTypeEnum.SPIKE });
         const compact = transformToCompact(spike, playerIndex);
         expect('c' in compact).toBe(false);
         expect('v' in compact).toBe(false);
@@ -51,4 +51,12 @@ describe('rally-event compact round trip -- positional fields (coords / speed /
         expect(decoded.speed).toBeUndefined();
         expect(decoded.digQuality).toBeUndefined();
     });
+    it('collapses legacy LINE_SHOT(1)/REVERSE_CROSS(2) to SPIKE(0) on decode (owner 2026-08-03)', () => {
+        // A zone-engine match persisted before the collapse carries type 1 or 2 in its jsonb; decode heals them to
+        // SPIKE so the match still opens. TIP(3) and up are untouched.
+        const base = transformToCompact(Spike.create({ playerId, score: 60, target: 4, failure: SpikeFailureEnum.NO_FAILURE, type: SpikeTypeEnum.SPIKE }), playerIndex);
+        expect(transformToSpike({ ...base, t: 1 }, roster).type).toBe(SpikeTypeEnum.SPIKE);
+        expect(transformToSpike({ ...base, t: 2 }, roster).type).toBe(SpikeTypeEnum.SPIKE);
+        expect(transformToSpike({ ...base, t: 3 }, roster).type).toBe(SpikeTypeEnum.TIP);
+    });
 });

package/dist/esm/src/data/transformers/rally-event.js

@@ -127,7 +127,9 @@ export function transformToSet(event, roster) {
 export function transformToSpike(event, roster) {
     return Spike.create({
         failure: event.f,
-        type: event.t,
+        // Legacy LINE_SHOT(1)/REVERSE_CROSS(2) collapse to SPIKE(0) (owner 2026-08-03): direction is redundant with
+        // the stored contact+landing coords. Maps old zone-engine matches so they keep decoding; new events emit 0/3-6.
+        type: event.t === 1 || event.t === 2 ? 0 : event.t,
         playerId: roster[event.p],
         target: event.a,
         score: event.s,

package/dist/esm/src/data/transformers/rally.test.js

@@ -17,7 +17,7 @@ describe('rally compact round trip — every event type', () => {
         Serve.create({ playerId: pA, target: 6, score: 55, failure: ServeFailureEnum.NO_FAILURE, type: ServeTypeEnum.JUMP_TOPSPIN }),
         Reception.create({ playerId: pB, target: 5, score: 50, failure: ReceptionFailureEnum.NO_FAILURE, type: ReceptionTypeEnum.DIG }),
         VolleySet.create({ playerId: pC, target: 3, score: 48, failure: SetFailureEnum.NO_FAILURE, type: SetTypeEnum.OVERHAND, tempo: SetTempoEnum.FIRST }),
-        Spike.create({ playerId: pA, target: 4, score: 62.5, failure: SpikeFailureEnum.NO_FAILURE, type: SpikeTypeEnum.CROSS_SHOT }),
+        Spike.create({ playerId: pA, target: 4, score: 62.5, failure: SpikeFailureEnum.NO_FAILURE, type: SpikeTypeEnum.SPIKE }),
         Block.create({ playerId: pB, blockers: [pB, pC], target: 8, score: 48, failure: BlockFailureEnum.NO_FAILURE, type: BlockTypeEnum.DOUBLE }),
         FreeBall.create({ playerId: pC, target: 6, score: 45, failure: FreeBallFailureEnum.NO_FAILURE, type: FreeBallTypeEnum.OVER })
     ];
@@ -47,7 +47,7 @@ describe('rally compact round trip — every event type', () => {
         expect(rec.type).toBe(ReceptionTypeEnum.DIG);
         expect(set.type).toBe(SetTypeEnum.OVERHAND);
         expect(set.tempo).toBe(SetTempoEnum.FIRST);
-        expect(spike.type).toBe(SpikeTypeEnum.CROSS_SHOT);
+        expect(spike.type).toBe(SpikeTypeEnum.SPIKE);
         expect(spike.score).toBe(62.5);
         expect(block.type).toBe(BlockTypeEnum.DOUBLE);
         expect(block.blockers).toEqual([pB, pC]);

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

@@ -80,6 +80,7 @@ function transformToAttributes(tactics, teamId) {
             tempos: p.tempos
         }))),
         serve_attack_shares: tactics.serveAttackShares ?? {},
+        base_positions: tactics.basePositions,
         blocking_preferences: tactics.blockingPreferences.map(p => ({ rotation: p.rotation, targets: p.targets })),
         blocking_preference_sets: tactics.blockingPreferenceSets?.map(prefs => prefs.map(p => ({ rotation: p.rotation, targets: p.targets }))),
         replace_knocked_immediately: tactics.replaceKnockedImmediately,
@@ -201,6 +202,7 @@ function transformToObject(model, roster) {
             }
             return healed;
         })(),
+        basePositions: model.base_positions ?? undefined,
         blockingPreferences: (model.blocking_preferences ?? []).map(p => ({ rotation: p.rotation, targets: p.targets })),
         blockingPreferenceSets: model.blocking_preference_sets?.map(prefs => prefs.map(p => ({ rotation: p.rotation, targets: p.targets }))),
         // LENIENT: keep only boolean entries keyed by a court starter or, when a second libero exists, the starting
@@ -361,6 +363,7 @@ function tacticsColumnsToApiDto(model) {
             }
             return Object.keys(healed).length > 0 ? healed : undefined;
         })(),
+        basePositions: model.base_positions ?? undefined,
         blockingPreferences: model.blocking_preferences,
         blockingPreferenceSets: model.blocking_preference_sets,
         // Same stale-data policy as the heals below: only boolean entries keyed by a court starter or, when a second
@@ -469,6 +472,7 @@ function apiTacticsConfigToAttributes(config, teamId) {
         system_sets: config.systemSets,
         offensive_preference_sets: config.offensivePreferenceSets,
         serve_attack_shares: config.serveAttackShares ?? {},
+        base_positions: config.basePositions,
         blocking_preferences: config.blockingPreferences ?? [],
         blocking_preference_sets: config.blockingPreferenceSets,
         replace_knocked_immediately: config.replaceKnockedImmediately,

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

@@ -225,6 +225,30 @@ describe('per-set tactics — service <-> row round-trip', () => {
         const back = transformToTactics(attrs, roster);
         expect(back.serveAttackShares).toEqual({});
     });
+    it('round-trips base positions (coords + reception participation)', () => {
+        const config = {
+            coords: { RECEIVE: { 1: { 5: { d: 5.5, r: -3 }, 6: { d: 6.5, r: 0 } } }, DEFENCE: { 3: { 2: { d: 0.9, r: 3 } } } },
+            receive: { 1: { 5: true, 2: false }, 4: { 6: true } }
+        };
+        const withBases = Tactics.create({
+            lineup: { 4: p4, 3: p3, 2: p2, 5: p5, 6: p6, 1: p1, bench: [] },
+            liberoReplacements: [],
+            basePositions: config
+        });
+        const attrs = transformFromTactics(withBases, 'team-1');
+        expect(attrs.base_positions).toEqual(config);
+        const back = transformToTactics(attrs, roster);
+        expect(back.basePositions).toEqual(config);
+    });
+    it('leaves basePositions undefined when the column is absent', () => {
+        const attrs = transformFromTactics(Tactics.create({
+            lineup: { 4: p4, 3: p3, 2: p2, 5: p5, 6: p6, 1: p1, bench: [] },
+            liberoReplacements: []
+        }), 'team-1');
+        expect(attrs.base_positions).toBeUndefined();
+        const back = transformToTactics(attrs, roster);
+        expect(back.basePositions).toBeUndefined();
+    });
     it('round-trips a per-starter tempos map on offensive preferences', () => {
         const withTempos = Tactics.create({
             lineup: { 4: p4, 3: p3, 2: p2, 5: p5, 6: p6, 1: p1, bench: [] },

package/dist/esm/src/service/event/schemas/spike.z.js

@@ -2,7 +2,9 @@ import { z } from 'zod';
 import { TraitEnum } from '../../player';
 import { EventIncidentSchema } from './incident.z';
 import { positionalEventFields } from './positional.z';
-const spikeTypeValues = [0, 1, 2, 3, 4, 5, 6];
+// SPIKE(0), TIP(3), DOWN_BALL(4), OVERHAND(5), TOOL(6). 1/2 (legacy LINE_SHOT/REVERSE_CROSS) are retired; the
+// codec (transformToSpike) maps them to 0 before this validates, so they never reach here.
+const spikeTypeValues = [0, 3, 4, 5, 6];
 const spikeFailureValues = [0, 1, 2, 3, 4];
 const courtTargetValues = Array.from({ length: 13 }, (_, i) => i);
 export const SpikeInputSchema = z.object({

package/dist/esm/src/service/event/spike.d.ts

@@ -1,14 +1,12 @@
 import { InPlayEvent } from './in-play-event';
 export declare enum SpikeTypeEnum {
-    CROSS_SHOT = 0,
-    LINE_SHOT = 1,
-    REVERSE_CROSS = 2,
+    SPIKE = 0,
     TIP = 3,
     DOWN_BALL = 4,
     OVERHAND = 5,
     TOOL = 6
 }
-export type SpikeType = SpikeTypeEnum.CROSS_SHOT | SpikeTypeEnum.LINE_SHOT | SpikeTypeEnum.REVERSE_CROSS | SpikeTypeEnum.TIP | SpikeTypeEnum.DOWN_BALL | SpikeTypeEnum.OVERHAND | SpikeTypeEnum.TOOL;
+export type SpikeType = SpikeTypeEnum.SPIKE | SpikeTypeEnum.TIP | SpikeTypeEnum.DOWN_BALL | SpikeTypeEnum.OVERHAND | SpikeTypeEnum.TOOL;
 export declare enum SpikeFailureEnum {
     NO_FAILURE = 0,
     FAULT = 1,

package/dist/esm/src/service/event/spike.js

@@ -3,9 +3,11 @@ import { InPlayEvent } from './in-play-event';
 import { SpikeInputSchema } from './schemas/spike.z';
 export var SpikeTypeEnum;
 (function (SpikeTypeEnum) {
-    SpikeTypeEnum[SpikeTypeEnum["CROSS_SHOT"] = 0] = "CROSS_SHOT";
-    SpikeTypeEnum[SpikeTypeEnum["LINE_SHOT"] = 1] = "LINE_SHOT";
-    SpikeTypeEnum[SpikeTypeEnum["REVERSE_CROSS"] = 2] = "REVERSE_CROSS";
+    // A hard swing (owner 2026-08-03). The cross / line / reverse DIRECTION is not stored: it is fully derivable
+    // from the persisted contact + landing coordinates, so a single SPIKE value replaces the old CROSS_SHOT(0) /
+    // LINE_SHOT(1) / REVERSE_CROSS(2). 1 and 2 are retired (left as gaps); the codec maps any legacy 1/2 back to
+    // SPIKE(0), so existing (zone-engine) matches keep decoding.
+    SpikeTypeEnum[SpikeTypeEnum["SPIKE"] = 0] = "SPIKE";
     SpikeTypeEnum[SpikeTypeEnum["TIP"] = 3] = "TIP";
     SpikeTypeEnum[SpikeTypeEnum["DOWN_BALL"] = 4] = "DOWN_BALL";
     SpikeTypeEnum[SpikeTypeEnum["OVERHAND"] = 5] = "OVERHAND";

package/dist/esm/src/service/team/base-config.d.ts

@@ -0,0 +1,10 @@
+export type BaseFormation = 'SERVE' | 'RECEIVE' | 'DEFENCE' | 'DEF_L' | 'DEF_M' | 'DEF_R' | 'ATTACK';
+export declare const BASE_FORMATIONS: readonly BaseFormation[];
+export interface BaseCoord {
+    readonly d: number;
+    readonly r: number;
+}
+export interface BaseConfig {
+    readonly coords: Record<string, Record<string, Record<string, BaseCoord>>>;
+    readonly receive: Record<string, Record<string, boolean>>;
+}

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

@@ -0,0 +1,11 @@
+// Per-team base-position configuration (owner 2026-08-03). Generalises the sim's hardcoded 5-1 preset into a
+// system-agnostic, per-team shape: for each formation, rotation and rotational ZONE, where that zone's player
+// stands, plus (serve-receive only) whether that zone's player passes the serve. Authored in the UI base editor
+// (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).
+export const BASE_FORMATIONS = ['SERVE', 'RECEIVE', 'DEFENCE', 'DEF_L', 'DEF_M', 'DEF_R', 'ATTACK'];

package/dist/esm/src/service/team/index.d.ts

@@ -2,6 +2,7 @@ export * from './team';
 export * from './team-generator';
 export * from './formation';
 export * from './tactics';
+export * from './base-config';
 export * from './team-name';
 export * from './energy-band';
 export * from './pinch-condition';

package/dist/esm/src/service/team/index.js

@@ -2,6 +2,7 @@ export * from './team';
 export * from './team-generator';
 export * from './formation';
 export * from './tactics';
+export * from './base-config';
 export * from './team-name';
 export * from './energy-band';
 export * from './pinch-condition';

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

@@ -288,6 +288,13 @@ export declare const TacticsInputSchema: z.ZodObject<{
         rotation: z.ZodNumber;
         targets: z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodEnum<typeof RoleEnum> & z.ZodType<RoleEnum.SETTER | RoleEnum.OUTSIDE_HITTER | RoleEnum.OPPOSITE_HITTER | RoleEnum.MIDDLE_BLOCKER, RoleEnum, z.core.$ZodTypeInternals<RoleEnum.SETTER | RoleEnum.OUTSIDE_HITTER | RoleEnum.OPPOSITE_HITTER | RoleEnum.MIDDLE_BLOCKER, RoleEnum>>, z.ZodLiteral<"NO_BLOCK">]>>;
     }, z.core.$strip>>>>;
+    basePositions: z.ZodOptional<z.ZodObject<{
+        coords: z.ZodRecord<z.ZodString, z.ZodRecord<z.ZodString, z.ZodRecord<z.ZodString, z.ZodObject<{
+            d: z.ZodNumber;
+            r: z.ZodNumber;
+        }, z.core.$strip>>>>;
+        receive: z.ZodRecord<z.ZodString, z.ZodRecord<z.ZodString, z.ZodBoolean>>;
+    }, z.core.$strip>>;
     replaceKnockedImmediately: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodBoolean>>;
     injuryReplacements: z.ZodDefault<z.ZodArray<z.ZodObject<{
         starter: z.ZodCustom<Player, Player>;

package/dist/esm/src/service/team/schemas/tactics.z.js

@@ -74,6 +74,15 @@ const systemSetSchema = z.object({
     rotationSystem: z.nativeEnum(RotationSystemEnum),
     designatedSetters: z.array(playerInstanceSchema)
 });
+// Base positions (owner 2026-08-03): coords[formation][rotation][zone] -> {d,r} + receive[rotation][zone] -> bool.
+// jsonb keys are strings; the coordinate + boolean leaves are validated. Structural key ranges (formation names,
+// rotations 1-6, zones 1-6) are trusted from the UI editor / preset compiler, which write the engine rotation
+// convention. Out-of-court coordinates are allowed, so d/r are not range-clamped here.
+const baseCoordSchema = z.object({ d: z.number().finite(), r: z.number().finite() });
+const baseConfigSchema = z.object({
+    coords: z.record(z.string(), z.record(z.string(), z.record(z.string(), baseCoordSchema))),
+    receive: z.record(z.string(), z.record(z.string(), z.boolean()))
+});
 export const TacticsInputSchema = z.object({
     lineup: lineupSchema,
     liberoReplacements: z.array(playerInstanceSchema),
@@ -104,6 +113,8 @@ export const TacticsInputSchema = z.object({
     // Blocking preferences (dedicated blocking). Defaults keep every existing Tactics.create({...}) call valid.
     blockingPreferences: z.array(blockingPreferenceSchema).default([]),
     blockingPreferenceSets: z.array(z.array(blockingPreferenceSchema)).max(5).optional(),
+    // Base positions (owner 2026-08-03). Optional -> the sim falls back to the default preset for the system.
+    basePositions: baseConfigSchema.optional(),
     // Injuries. Defaults keep every existing Tactics.create({...}) call valid. replaceKnockedImmediately is
     // PER STARTER (owner order 2026-07-05): keyed by starter id, missing key = ON; keys validated against the
     // lineup in the superRefine below. injuryReplacements is the per-starter explicit replacement mapping

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

@@ -296,6 +296,13 @@ export declare const TeamInputSchema: z.ZodObject<{
             rotation: z.ZodNumber;
             targets: z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodEnum<typeof import("../../player").RoleEnum> & z.ZodType<import("../../player").RoleEnum.SETTER | import("../../player").RoleEnum.OUTSIDE_HITTER | import("../../player").RoleEnum.OPPOSITE_HITTER | import("../../player").RoleEnum.MIDDLE_BLOCKER, import("../../player").RoleEnum, z.core.$ZodTypeInternals<import("../../player").RoleEnum.SETTER | import("../../player").RoleEnum.OUTSIDE_HITTER | import("../../player").RoleEnum.OPPOSITE_HITTER | import("../../player").RoleEnum.MIDDLE_BLOCKER, import("../../player").RoleEnum>>, z.ZodLiteral<"NO_BLOCK">]>>;
         }, z.core.$strip>>>>;
+        basePositions: z.ZodOptional<z.ZodObject<{
+            coords: z.ZodRecord<z.ZodString, z.ZodRecord<z.ZodString, z.ZodRecord<z.ZodString, z.ZodObject<{
+                d: z.ZodNumber;
+                r: z.ZodNumber;
+            }, z.core.$strip>>>>;
+            receive: z.ZodRecord<z.ZodString, z.ZodRecord<z.ZodString, z.ZodBoolean>>;
+        }, z.core.$strip>>;
         replaceKnockedImmediately: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodBoolean>>;
         injuryReplacements: z.ZodDefault<z.ZodArray<z.ZodObject<{
             starter: z.ZodCustom<Player, Player>;

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

@@ -8,6 +8,7 @@ import { OffensivePreference } from './offensive-preference';
 import { BlockingPreference } from './blocking-preference';
 import { InjuryReplacement } from './injury-replacement';
 import { LiberoInjuryConfig } from './libero-injury';
+import { BaseConfig } from './base-config';
 export interface StartingLineup {
     readonly [CourtPosition.LEFT_FRONT]: Player;
     readonly [CourtPosition.MIDDLE_FRONT]: Player;
@@ -42,6 +43,7 @@ export interface TacticsOpts {
     readonly liberoInjury?: LiberoInjuryConfig;
     readonly blockingPreferences: BlockingPreference[];
     readonly blockingPreferenceSets?: BlockingPreference[][];
+    readonly basePositions?: BaseConfig;
 }
 export declare class Tactics {
     readonly lineup: StartingLineup;
@@ -63,6 +65,7 @@ export declare class Tactics {
     readonly liberoInjury?: LiberoInjuryConfig;
     readonly blockingPreferences: BlockingPreference[];
     readonly blockingPreferenceSets?: BlockingPreference[][];
+    readonly basePositions?: BaseConfig;
     static create(input: unknown): Tactics;
     private constructor();
     findPlayerInLineup(id: string): CourtPosition | undefined;

package/dist/esm/src/service/team/tactics.js

@@ -15,7 +15,7 @@ export class Tactics {
         }
         return new Tactics(result.data);
     }
-    constructor({ lineup, liberoReplacements, receiveRotationOffset = false, designatedSubs = [], substitutionBand = EnergyBand.TIRED, secondLibero, liberoSub, liberoReplacementSets, rotationSystem = RotationSystemEnum.SIX_ZERO, designatedSetters = [], offensivePreferences = [], serveAttackShares = {}, systemSets, offensivePreferenceSets, replaceKnockedImmediately = {}, injuryReplacements = [], liberoInjury, blockingPreferences = [], blockingPreferenceSets }) {
+    constructor({ lineup, liberoReplacements, receiveRotationOffset = false, designatedSubs = [], substitutionBand = EnergyBand.TIRED, secondLibero, liberoSub, liberoReplacementSets, rotationSystem = RotationSystemEnum.SIX_ZERO, designatedSetters = [], offensivePreferences = [], serveAttackShares = {}, systemSets, offensivePreferenceSets, replaceKnockedImmediately = {}, injuryReplacements = [], liberoInjury, blockingPreferences = [], blockingPreferenceSets, basePositions }) {
         this.lineup = lineup;
         this.liberoReplacements = liberoReplacements;
         this.receiveRotationOffset = receiveRotationOffset;
@@ -35,6 +35,7 @@ export class Tactics {
         this.liberoInjury = liberoInjury;
         this.blockingPreferences = blockingPreferences;
         this.blockingPreferenceSets = blockingPreferenceSets;
+        this.basePositions = basePositions;
     }
     findPlayerInLineup(id) {
         if (this.lineup.bench.some(p => p.id === id))

package/package.json

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