volleyballsimtypes 0.0.504 → 0.0.506

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, DefenceFormation, CourtPosition, ConditionLogic, EnergyBand, MatchForfeitType, PerformanceStats, PinchCondition, RotationSystemEnum, SubBackMode, SubBand } from '../service';
 export * from './tactics-player-refs';
 export type Rally = DataProps<_Rally> & {
     homePlayerPosition: PlayerPosition[];
@@ -102,7 +102,7 @@ export interface ApiOffensivePreference {
 }
 export interface ApiBlockingPreference {
     rotation: number;
-    targets: Record<string, BlockingAssignment>;
+    targets: Record<DefenceFormation, Record<string, BlockingAssignment>>;
 }
 export interface ApiSystemSet {
     rotationSystem: RotationSystemEnum;
@@ -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/api/tactics-player-refs.js

@@ -29,8 +29,8 @@ function collectTacticsPlayerIds(config) {
         ...((config.offensivePreferences ?? []).flatMap(p => Object.keys(p.weights))),
         ...((config.systemSets ?? []).flatMap(s => s.designatedSetters)),
         ...((config.offensivePreferenceSets ?? []).flat().flatMap(p => Object.keys(p.weights))),
-        ...((config.blockingPreferences ?? []).flatMap(p => Object.keys(p.targets))),
-        ...((config.blockingPreferenceSets ?? []).flat().flatMap(p => Object.keys(p.targets))),
+        ...((config.blockingPreferences ?? []).flatMap(p => Object.values(p.targets).flatMap(m => Object.keys(m ?? {})))),
+        ...((config.blockingPreferenceSets ?? []).flat().flatMap(p => Object.values(p.targets).flatMap(m => Object.keys(m ?? {})))),
         // Injury replacements reference reserves (roster players outside the lineup); roster membership is the only
         // player check possible here (the schema enforces the bench/reserve role rules).
         ...((config.injuryReplacements ?? []).flatMap(ir => [ir.starterId, ir.replacementId, ir.benchBackfillId])),

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

@@ -27,6 +27,7 @@ function initModels(sequelize) {
     const Wishlist = models_1.WishlistModel.initModel(sequelize);
     const UserSettings = models_1.UserSettingsModel.initModel(sequelize);
     const UserDeviceToken = models_1.UserDeviceTokenModel.initModel(sequelize);
+    const BasePositionPreset = models_1.BasePositionPresetModel.initModel(sequelize);
     const Notification = models_1.NotificationModel.initModel(sequelize);
     const AuthIdentity = models_1.AuthIdentityModel.initModel(sequelize);
     const AuthSession = models_1.AuthSessionModel.initModel(sequelize);
@@ -75,8 +76,10 @@ function initModels(sequelize) {
     AuthUser.hasOne(Wishlist, { as: 'Wishlist', foreignKey: 'user_id' });
     AuthUser.hasOne(UserSettings, { as: 'UserSettings', 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' });
     UserDeviceToken.belongsTo(AuthUser, { as: 'user', foreignKey: 'user_id' });
+    BasePositionPreset.belongsTo(AuthUser, { as: 'user', foreignKey: 'user_id' });
     Notification.belongsTo(AuthUser, { as: 'user', foreignKey: 'user_id' });
     AuthUser.hasMany(GachaPullHistory, { as: 'GachaPullHistory', foreignKey: 'user_id' });
     AuthUser.hasMany(UserPullGrant, { as: 'UserPullGrants', foreignKey: 'user_id' });
@@ -354,6 +357,7 @@ function initModels(sequelize) {
         Wishlist,
         UserSettings,
         UserDeviceToken,
+        BasePositionPreset,
         Notification,
         Coach,
         Scout,

package/dist/cjs/src/data/models/base-position-preset.d.ts

@@ -0,0 +1,22 @@
+import * as Sequelize from 'sequelize';
+import { Model, Optional } from 'sequelize';
+import { BaseConfig } from '../../service';
+export interface BasePositionPresetAttributes {
+    preset_id: string;
+    user_id: string;
+    name: string;
+    config: BaseConfig;
+    created_at?: Date;
+}
+export type BasePositionPresetPk = 'preset_id';
+export type BasePositionPresetId = BasePositionPresetModel[BasePositionPresetPk];
+export type BasePositionPresetOptionalAttributes = 'preset_id' | 'created_at';
+export type BasePositionPresetCreationAttributes = Optional<BasePositionPresetAttributes, BasePositionPresetOptionalAttributes>;
+export declare class BasePositionPresetModel extends Model<BasePositionPresetAttributes, BasePositionPresetCreationAttributes> implements BasePositionPresetAttributes {
+    preset_id: string;
+    user_id: string;
+    name: string;
+    config: BaseConfig;
+    created_at?: Date;
+    static initModel(sequelize: Sequelize.Sequelize): typeof BasePositionPresetModel;
+}

package/dist/cjs/src/data/models/base-position-preset.js

@@ -0,0 +1,54 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BasePositionPresetModel = void 0;
+const sequelize_1 = require("sequelize");
+class BasePositionPresetModel extends sequelize_1.Model {
+    static initModel(sequelize) {
+        return BasePositionPresetModel.init({
+            preset_id: {
+                type: sequelize_1.DataTypes.UUID,
+                allowNull: false,
+                primaryKey: true,
+                defaultValue: sequelize_1.DataTypes.UUIDV4
+            },
+            user_id: {
+                type: sequelize_1.DataTypes.UUID,
+                allowNull: false,
+                references: {
+                    model: 'AuthUser',
+                    key: 'user_id'
+                }
+            },
+            name: {
+                type: sequelize_1.DataTypes.STRING,
+                allowNull: false
+            },
+            config: {
+                type: sequelize_1.DataTypes.JSONB,
+                allowNull: false
+            },
+            created_at: {
+                type: sequelize_1.DataTypes.DATE,
+                allowNull: false,
+                defaultValue: sequelize_1.DataTypes.NOW
+            }
+        }, {
+            sequelize,
+            tableName: 'BasePositionPreset',
+            schema: 'public',
+            timestamps: false,
+            indexes: [
+                {
+                    name: 'BasePositionPreset_pk',
+                    unique: true,
+                    fields: [{ name: 'preset_id' }]
+                },
+                {
+                    name: 'BasePositionPreset_user_id_idx',
+                    fields: [{ name: 'user_id' }]
+                }
+            ]
+        });
+    }
+}
+exports.BasePositionPresetModel = BasePositionPresetModel;

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

@@ -38,6 +38,7 @@ export * from './team';
 export * from './team-replacement';
 export * from './tactics';
 export * from './lineup-preset';
+export * from './base-position-preset';
 export * from './event';
 export * from './event-competition';
 export * from './event-bot-team';

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

@@ -54,6 +54,7 @@ __exportStar(require("./team"), exports);
 __exportStar(require("./team-replacement"), exports);
 __exportStar(require("./tactics"), exports);
 __exportStar(require("./lineup-preset"), exports);
+__exportStar(require("./base-position-preset"), exports);
 __exportStar(require("./event"), exports);
 __exportStar(require("./event-competition"), exports);
 __exportStar(require("./event-bot-team"), exports);

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, DefenceFormation, EnergyBand, PinchCondition, RotationSystemEnum, SubBackMode, SubBand, SubMode } from '../../service';
 export interface TacticsLineupAttributes {
     [CourtPosition.LIBERO_ZONE]?: PlayerId;
     [CourtPosition.LEFT_BACK]: PlayerId;
@@ -36,7 +36,7 @@ export interface OffensivePreferenceAttributes {
 }
 export interface BlockingPreferenceAttributes {
     rotation: number;
-    targets: Record<PlayerId, BlockingAssignment>;
+    targets: Record<DefenceFormation, Record<PlayerId, BlockingAssignment>>;
 }
 export interface SystemSetAttributes {
     rotationSystem: RotationSystemEnum;
@@ -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: [] },
@@ -240,18 +264,18 @@ function makeTactics(designatedSubs) {
         const back = (0, tactics_1.transformToTactics)(attrs, roster);
         (0, globals_1.expect)(back.offensivePreferences[0].tempos).toEqual({ [p2.id]: 'FAST', [p3.id]: 'HIGH' });
     });
-    (0, globals_1.it)('round-trips blocking preferences as id-keyed function maps', () => {
+    (0, globals_1.it)('round-trips blocking preferences as per-defence-side id-keyed function maps', () => {
         const withBlocking = service_1.Tactics.create({
             lineup: { 4: p4, 3: p3, 2: p2, 5: p5, 6: p6, 1: p1, bench: [] },
             liberoReplacements: [],
-            blockingPreferences: [{ rotation: 1, targets: { [p4.id]: service_1.RoleEnum.OUTSIDE_HITTER, [p3.id]: service_1.RoleEnum.MIDDLE_BLOCKER } }]
+            blockingPreferences: [{ rotation: 1, targets: { DEF_L: { [p4.id]: service_1.RoleEnum.OUTSIDE_HITTER }, DEF_R: { [p3.id]: service_1.RoleEnum.MIDDLE_BLOCKER } } }]
         });
         const attrs = (0, tactics_1.transformFromTactics)(withBlocking, 'team-1');
         (0, globals_1.expect)(attrs.blocking_preferences).toEqual([
-            { rotation: 1, targets: { [p4.id]: service_1.RoleEnum.OUTSIDE_HITTER, [p3.id]: service_1.RoleEnum.MIDDLE_BLOCKER } }
+            { rotation: 1, targets: { DEF_L: { [p4.id]: service_1.RoleEnum.OUTSIDE_HITTER }, DEF_M: {}, DEF_R: { [p3.id]: service_1.RoleEnum.MIDDLE_BLOCKER } } }
         ]);
         const back = (0, tactics_1.transformToTactics)(attrs, roster);
-        (0, globals_1.expect)(back.blockingPreferences[0].targets).toEqual({ [p4.id]: service_1.RoleEnum.OUTSIDE_HITTER, [p3.id]: service_1.RoleEnum.MIDDLE_BLOCKER });
+        (0, globals_1.expect)(back.blockingPreferences[0].targets).toEqual({ DEF_L: { [p4.id]: service_1.RoleEnum.OUTSIDE_HITTER }, DEF_M: {}, DEF_R: { [p3.id]: service_1.RoleEnum.MIDDLE_BLOCKER } });
     });
     // NO_BLOCK rides in the same targets map as a commit assignment, so the transformers copy it wholesale with no
     // mapping code. This pins that: the sentinel must survive the row round-trip verbatim, mixed with a commit, and
@@ -260,17 +284,17 @@ function makeTactics(designatedSubs) {
         const withNoBlock = service_1.Tactics.create({
             lineup: { 4: p4, 3: p3, 2: p2, 5: p5, 6: p6, 1: p1, bench: [] },
             liberoReplacements: [],
-            blockingPreferences: [{ rotation: 1, targets: { [p4.id]: service_1.NO_BLOCK, [p3.id]: service_1.RoleEnum.MIDDLE_BLOCKER } }],
-            blockingPreferenceSets: [[{ rotation: 2, targets: { [p2.id]: service_1.NO_BLOCK } }]]
+            blockingPreferences: [{ rotation: 1, targets: { DEF_M: { [p4.id]: service_1.NO_BLOCK, [p3.id]: service_1.RoleEnum.MIDDLE_BLOCKER } } }],
+            blockingPreferenceSets: [[{ rotation: 2, targets: { DEF_L: { [p2.id]: service_1.NO_BLOCK } } }]]
         });
         const attrs = (0, tactics_1.transformFromTactics)(withNoBlock, 'team-1');
         (0, globals_1.expect)(attrs.blocking_preferences).toEqual([
-            { rotation: 1, targets: { [p4.id]: service_1.NO_BLOCK, [p3.id]: service_1.RoleEnum.MIDDLE_BLOCKER } }
+            { rotation: 1, targets: { DEF_L: {}, DEF_M: { [p4.id]: service_1.NO_BLOCK, [p3.id]: service_1.RoleEnum.MIDDLE_BLOCKER }, DEF_R: {} } }
         ]);
-        (0, globals_1.expect)(attrs.blocking_preference_sets).toEqual([[{ rotation: 2, targets: { [p2.id]: service_1.NO_BLOCK } }]]);
+        (0, globals_1.expect)(attrs.blocking_preference_sets).toEqual([[{ rotation: 2, targets: { DEF_L: { [p2.id]: service_1.NO_BLOCK }, DEF_M: {}, DEF_R: {} } }]]);
         const back = (0, tactics_1.transformToTactics)(attrs, roster);
-        (0, globals_1.expect)(back.blockingPreferences[0].targets).toEqual({ [p4.id]: service_1.NO_BLOCK, [p3.id]: service_1.RoleEnum.MIDDLE_BLOCKER });
-        (0, globals_1.expect)(back.blockingPreferenceSets?.[0][0].targets).toEqual({ [p2.id]: service_1.NO_BLOCK });
+        (0, globals_1.expect)(back.blockingPreferences[0].targets).toEqual({ DEF_L: {}, DEF_M: { [p4.id]: service_1.NO_BLOCK, [p3.id]: service_1.RoleEnum.MIDDLE_BLOCKER }, DEF_R: {} });
+        (0, globals_1.expect)(back.blockingPreferenceSets?.[0][0].targets).toEqual({ DEF_L: { [p2.id]: service_1.NO_BLOCK }, DEF_M: {}, DEF_R: {} });
     });
 });
 (0, globals_1.describe)('libero injuries — service <-> row round-trip + lenient heal', () => {

package/dist/cjs/src/service/competition/competition-rewards.d.ts

@@ -0,0 +1,20 @@
+export type CompetitionRewardKind = 'REGIONAL' | 'NATIONAL' | 'WCC';
+export interface CompetitionRewardRow {
+    /** Best final position that still earns this row: the "Top N" band. */
+    readonly maxPosition: number;
+    /** Coins awarded by this row alone (the increment, not the running total). */
+    readonly coins: number;
+    /** Recruit-reward pulls awarded by this row alone (the competition's own pull type). */
+    readonly recruits: number;
+}
+/** Per-competition bands, widest band first (the order the docs list them, with a growing cumulative total). */
+export declare const COMPETITION_REWARDS: Readonly<Record<CompetitionRewardKind, readonly CompetitionRewardRow[]>>;
+export interface CompetitionPayout {
+    readonly coins: number;
+    readonly recruits: number;
+}
+/**
+ * Everything a finishing position earns in the given competition: the sum of every band that still includes the
+ * position (cumulative). Positions past the lowest band earn nothing. `position` is the 1-based final placement.
+ */
+export declare function competitionPayoutFor(kind: CompetitionRewardKind, position: number): CompetitionPayout;

package/dist/cjs/src/service/competition/competition-rewards.js

@@ -0,0 +1,47 @@
+"use strict";
+// What the knockout competitions (Regional Cup, National Cup, WCC) pay out by final placement. Owner-defined
+// 2026-08-07. Like the event and league rewards, these are CUMULATIVE: a finish earns its band and every band
+// below it. Each band gives coins and/or "recruit rewards" (the competition's own pull grant: a Regional
+// recruit is a QUALIFIER pull, a National recruit a NATIONAL pull, a WCC recruit a TOURNAMENT pull). Recruit
+// rewards stack, so a champion collects one per qualifying band.
+//
+// One source of truth for two consumers: the simulator grants from it and the UI competition docs render it.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.COMPETITION_REWARDS = void 0;
+exports.competitionPayoutFor = competitionPayoutFor;
+/** Per-competition bands, widest band first (the order the docs list them, with a growing cumulative total). */
+exports.COMPETITION_REWARDS = {
+    REGIONAL: [
+        { maxPosition: 4, coins: 1000, recruits: 0 },
+        { maxPosition: 3, coins: 0, recruits: 1 },
+        { maxPosition: 2, coins: 1000, recruits: 0 },
+        { maxPosition: 1, coins: 500, recruits: 1 }
+    ],
+    NATIONAL: [
+        { maxPosition: 8, coins: 1000, recruits: 0 },
+        { maxPosition: 4, coins: 500, recruits: 1 },
+        { maxPosition: 2, coins: 500, recruits: 0 },
+        { maxPosition: 1, coins: 0, recruits: 1 }
+    ],
+    WCC: [
+        { maxPosition: 4, coins: 1000, recruits: 0 },
+        { maxPosition: 3, coins: 0, recruits: 1 },
+        { maxPosition: 2, coins: 500, recruits: 1 },
+        { maxPosition: 1, coins: 500, recruits: 1 }
+    ]
+};
+/**
+ * Everything a finishing position earns in the given competition: the sum of every band that still includes the
+ * position (cumulative). Positions past the lowest band earn nothing. `position` is the 1-based final placement.
+ */
+function competitionPayoutFor(kind, position) {
+    let coins = 0;
+    let recruits = 0;
+    for (const row of exports.COMPETITION_REWARDS[kind]) {
+        if (position <= row.maxPosition) {
+            coins += row.coins;
+            recruits += row.recruits;
+        }
+    }
+    return { coins, recruits };
+}

package/dist/cjs/src/service/competition/competition-rewards.test.d.ts

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

package/dist/cjs/src/service/competition/competition-rewards.test.js

@@ -0,0 +1,32 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const globals_1 = require("@jest/globals");
+const competition_rewards_1 = require("./competition-rewards");
+// The cumulative per-position totals the owner specified (2026-08-07): { coins, recruits } a finish earns,
+// summing its band and every band below. Positions past the lowest band earn nothing.
+(0, globals_1.describe)('competitionPayoutFor', () => {
+    const CASES = {
+        // position: [coins, recruits]
+        REGIONAL: { 1: [2500, 2], 2: [2000, 1], 3: [1000, 1], 4: [1000, 0], 5: [0, 0] },
+        NATIONAL: { 1: [2000, 2], 2: [2000, 1], 3: [1500, 1], 4: [1500, 1], 5: [1000, 0], 8: [1000, 0], 9: [0, 0] },
+        WCC: { 1: [2000, 3], 2: [1500, 2], 3: [1000, 1], 4: [1000, 0], 5: [0, 0] }
+    };
+    for (const kind of Object.keys(CASES)) {
+        (0, globals_1.it)(`matches the owner totals for ${kind}`, () => {
+            for (const [pos, [coins, recruits]] of Object.entries(CASES[kind])) {
+                (0, globals_1.expect)((0, competition_rewards_1.competitionPayoutFor)(kind, Number(pos))).toEqual({ coins, recruits });
+            }
+        });
+    }
+    (0, globals_1.it)('champion collects one recruit per qualifying band', () => {
+        (0, globals_1.expect)((0, competition_rewards_1.competitionPayoutFor)('REGIONAL', 1).recruits).toBe(2);
+        (0, globals_1.expect)((0, competition_rewards_1.competitionPayoutFor)('NATIONAL', 1).recruits).toBe(2);
+        (0, globals_1.expect)((0, competition_rewards_1.competitionPayoutFor)('WCC', 1).recruits).toBe(3);
+    });
+    (0, globals_1.it)('champion coin total equals the sum of the band table', () => {
+        const sum = (k) => competition_rewards_1.COMPETITION_REWARDS[k].reduce((s, r) => s + r.coins, 0);
+        (0, globals_1.expect)((0, competition_rewards_1.competitionPayoutFor)('REGIONAL', 1).coins).toBe(sum('REGIONAL'));
+        (0, globals_1.expect)((0, competition_rewards_1.competitionPayoutFor)('NATIONAL', 1).coins).toBe(sum('NATIONAL'));
+        (0, globals_1.expect)((0, competition_rewards_1.competitionPayoutFor)('WCC', 1).coins).toBe(sum('WCC'));
+    });
+});

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

@@ -3,6 +3,8 @@ export * from './season';
 export * from './event-schedule';
 export * from './event-draft';
 export * from './event-rewards';
+export * from './league-rewards';
+export * from './competition-rewards';
 export * from './league';
 export * from './division';
 export * from './iteration';

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

@@ -19,6 +19,8 @@ __exportStar(require("./season"), exports);
 __exportStar(require("./event-schedule"), exports);
 __exportStar(require("./event-draft"), exports);
 __exportStar(require("./event-rewards"), exports);
+__exportStar(require("./league-rewards"), exports);
+__exportStar(require("./competition-rewards"), exports);
 __exportStar(require("./league"), exports);
 __exportStar(require("./division"), exports);
 __exportStar(require("./iteration"), exports);

package/dist/cjs/src/service/competition/league-rewards.d.ts

@@ -0,0 +1,21 @@
+export interface LeagueRewardRow {
+    /** Best final position that still earns this row: the "Top N" band. */
+    readonly maxPosition: number;
+    /** Coins awarded by this row alone (the increment, not the running total). */
+    readonly coins: number;
+}
+/** Division tiers that get their own reward table. Tier 3 covers "division 3 and lower". */
+export type LeagueRewardTier = 1 | 2 | 3;
+/**
+ * Per-tier bands, widest band first (the order the standings doc lists them, with a growing cumulative total).
+ * A team earns every row whose band still includes its finishing position, which is what "cumulative" means.
+ */
+export declare const LEAGUE_REWARDS: Readonly<Record<LeagueRewardTier, readonly LeagueRewardRow[]>>;
+/** Clamp any division tier to a reward table: tier 1, tier 2, and tier 3-and-lower share the tier-3 table. */
+export declare function leagueRewardTier(tier: number): LeagueRewardTier;
+/**
+ * Coins a finishing position earns in a division of the given tier: the sum of every band that still includes
+ * the position (cumulative). Positions past the lowest band earn 0. `position` is the 1-based final standings
+ * place.
+ */
+export declare function leaguePayoutFor(tier: number, position: number): number;

package/dist/cjs/src/service/competition/league-rewards.js

@@ -0,0 +1,58 @@
+"use strict";
+// What a league season pays out at the end, by division tier and final standings position. Owner-defined
+// 2026-08-07. Like the event rewards, these are CUMULATIVE: a team collects its own band and every band below
+// it, so first place collects them all. Positions past the lowest band earn nothing.
+//
+// One source of truth for two consumers: the simulator grants from it (assignSeasonPayoutIfMissing) and the UI
+// standings doc renders it.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LEAGUE_REWARDS = void 0;
+exports.leagueRewardTier = leagueRewardTier;
+exports.leaguePayoutFor = leaguePayoutFor;
+/**
+ * Per-tier bands, widest band first (the order the standings doc lists them, with a growing cumulative total).
+ * A team earns every row whose band still includes its finishing position, which is what "cumulative" means.
+ */
+exports.LEAGUE_REWARDS = {
+    1: [
+        { maxPosition: 12, coins: 1000 },
+        { maxPosition: 8, coins: 500 },
+        { maxPosition: 4, coins: 500 },
+        { maxPosition: 3, coins: 250 },
+        { maxPosition: 2, coins: 250 },
+        { maxPosition: 1, coins: 500 }
+    ],
+    2: [
+        { maxPosition: 8, coins: 500 },
+        { maxPosition: 4, coins: 500 },
+        { maxPosition: 2, coins: 250 },
+        { maxPosition: 1, coins: 250 }
+    ],
+    3: [
+        { maxPosition: 4, coins: 500 },
+        { maxPosition: 2, coins: 250 },
+        { maxPosition: 1, coins: 250 }
+    ]
+};
+/** Clamp any division tier to a reward table: tier 1, tier 2, and tier 3-and-lower share the tier-3 table. */
+function leagueRewardTier(tier) {
+    const t = Math.trunc(tier);
+    if (t <= 1)
+        return 1;
+    if (t === 2)
+        return 2;
+    return 3;
+}
+/**
+ * Coins a finishing position earns in a division of the given tier: the sum of every band that still includes
+ * the position (cumulative). Positions past the lowest band earn 0. `position` is the 1-based final standings
+ * place.
+ */
+function leaguePayoutFor(tier, position) {
+    let coins = 0;
+    for (const row of exports.LEAGUE_REWARDS[leagueRewardTier(tier)]) {
+        if (position <= row.maxPosition)
+            coins += row.coins;
+    }
+    return coins;
+}

package/dist/cjs/src/service/competition/league-rewards.test.d.ts

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