volleyballsimtypes 0.0.499 → 0.0.501

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

@@ -139,6 +139,7 @@ export interface Tactics {
     offensivePreferences: ApiOffensivePreference[];
     systemSets?: ApiSystemSet[];
     offensivePreferenceSets?: ApiOffensivePreference[][];
+    serveAttackShares?: Record<string, number>;
     blockingPreferences: ApiBlockingPreference[];
     blockingPreferenceSets?: ApiBlockingPreference[][];
     replaceKnockedImmediately?: Record<string, boolean>;

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

@@ -76,6 +76,7 @@ export interface TacticsAttributes {
     offensive_preferences: OffensivePreferenceAttributes[];
     system_sets?: SystemSetAttributes[];
     offensive_preference_sets?: OffensivePreferenceAttributes[][];
+    serve_attack_shares: Record<PlayerId, number>;
     replace_knocked_immediately?: Record<PlayerId, boolean>;
     injury_replacements?: InjuryReplacementAttributes[];
     libero_injury?: LiberoInjuryAttributes;
@@ -84,7 +85,7 @@ export interface TacticsAttributes {
 }
 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' | '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';
 export type TacticsCreationAttributes = Optional<TacticsAttributes, TacticsOptionalAttributes>;
 export declare class TacticsModel extends Model<TacticsAttributes, TacticsCreationAttributes> implements TacticsAttributes {
     team_id: string;
@@ -101,6 +102,7 @@ export declare class TacticsModel extends Model<TacticsAttributes, TacticsCreati
     offensive_preferences: OffensivePreferenceAttributes[];
     system_sets?: SystemSetAttributes[];
     offensive_preference_sets?: OffensivePreferenceAttributes[][];
+    serve_attack_shares: Record<PlayerId, number>;
     replace_knocked_immediately?: Record<PlayerId, boolean>;
     injury_replacements?: InjuryReplacementAttributes[];
     libero_injury?: LiberoInjuryAttributes;

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

@@ -75,6 +75,11 @@ class TacticsModel extends sequelize_1.Model {
                 type: sequelize_1.DataTypes.JSONB,
                 allowNull: true
             },
+            serve_attack_shares: {
+                type: sequelize_1.DataTypes.JSONB,
+                allowNull: false,
+                defaultValue: {}
+            },
             replace_knocked_immediately: {
                 type: sequelize_1.DataTypes.JSONB,
                 allowNull: true

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

@@ -85,6 +85,7 @@ function transformToAttributes(tactics, teamId) {
             weights: p.weights,
             tempos: p.tempos
         }))),
+        serve_attack_shares: tactics.serveAttackShares ?? {},
         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,
@@ -191,6 +192,21 @@ function transformToObject(model, roster) {
             weights: p.weights,
             tempos: p.tempos
         }))),
+        // LENIENT: keep only serve shares keyed by a current libero-replacement (flat or per-set) with a value in the
+        // 0-100 band, so a stale key (a released player, or a libero-replacement config change) can never fail schema
+        // validation and crash a team load; a dropped key = no serve share.
+        serveAttackShares: (() => {
+            const liberoReplacementIds = new Set([
+                ...model.libero_replacements,
+                ...(model.libero_replacement_sets ?? []).flat()
+            ]);
+            const healed = {};
+            for (const [id, value] of Object.entries(model.serve_attack_shares ?? {})) {
+                if (liberoReplacementIds.has(id) && typeof value === 'number' && value >= 0 && value <= 100)
+                    healed[id] = value;
+            }
+            return healed;
+        })(),
         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
@@ -336,6 +352,21 @@ function tacticsColumnsToApiDto(model) {
         offensivePreferences: model.offensive_preferences,
         systemSets: model.system_sets,
         offensivePreferenceSets: model.offensive_preference_sets,
+        // Same stale-data policy as the heals below: only serve shares keyed by a current libero-replacement (flat or
+        // per-set) with a value in the 0-100 band survive; an empty map surfaces as absent so the UI never reloads and
+        // re-emits a stale key.
+        serveAttackShares: (() => {
+            const liberoReplacementIds = new Set([
+                ...model.libero_replacements,
+                ...(model.libero_replacement_sets ?? []).flat()
+            ]);
+            const healed = {};
+            for (const [id, value] of Object.entries(model.serve_attack_shares ?? {})) {
+                if (liberoReplacementIds.has(id) && typeof value === 'number' && value >= 0 && value <= 100)
+                    healed[id] = value;
+            }
+            return Object.keys(healed).length > 0 ? healed : 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
@@ -443,6 +474,7 @@ function apiTacticsConfigToAttributes(config, teamId) {
         offensive_preferences: config.offensivePreferences,
         system_sets: config.systemSets,
         offensive_preference_sets: config.offensivePreferenceSets,
+        serve_attack_shares: config.serveAttackShares ?? {},
         blocking_preferences: config.blockingPreferences ?? [],
         blocking_preference_sets: config.blockingPreferenceSets,
         replace_knocked_immediately: config.replaceKnockedImmediately,

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

@@ -143,6 +143,22 @@ function makeTactics(designatedSubs) {
         (0, globals_1.expect)(dto.systemSets).toBeUndefined();
         (0, globals_1.expect)(dto.offensivePreferenceSets).toBeUndefined();
     });
+    (0, globals_1.it)('surfaces serve attack shares keyed by a libero replacement', () => {
+        const model = makeTactics([]);
+        model.serve_attack_shares = { lf: 30 }; // lf is the configured libero_replacement
+        const dto = (0, tactics_1.tacticsColumnsToApiDto)(model);
+        (0, globals_1.expect)(dto.serveAttackShares).toEqual({ lf: 30 });
+    });
+    (0, globals_1.it)('drops a serve attack share keyed by a non-libero-replacement (stale heal)', () => {
+        const model = makeTactics([]);
+        model.serve_attack_shares = { lf: 30, rf: 40 }; // rf is not in libero_replacements (['lf'])
+        const dto = (0, tactics_1.tacticsColumnsToApiDto)(model);
+        (0, globals_1.expect)(dto.serveAttackShares).toEqual({ lf: 30 });
+    });
+    (0, globals_1.it)('leaves serveAttackShares undefined when the column is empty', () => {
+        const dto = (0, tactics_1.tacticsColumnsToApiDto)(makeTactics([]));
+        (0, globals_1.expect)(dto.serveAttackShares).toBeUndefined();
+    });
 });
 (0, globals_1.describe)('per-set tactics — service <-> row round-trip', () => {
     const country = (0, test_helpers_1.makeCountry)();
@@ -190,6 +206,27 @@ function makeTactics(designatedSubs) {
         (0, globals_1.expect)(back.systemSets).toBeUndefined();
         (0, globals_1.expect)(back.offensivePreferenceSets).toBeUndefined();
     });
+    (0, globals_1.it)('round-trips serve attack shares keyed by a libero replacement', () => {
+        const withServe = service_1.Tactics.create({
+            lineup: { 4: p4, 3: p3, 2: p2, 5: p5, 6: p6, 1: p1, bench: [] },
+            liberoReplacements: [p5],
+            serveAttackShares: { [p5.id]: 35 }
+        });
+        const attrs = (0, tactics_1.transformFromTactics)(withServe, 'team-1');
+        (0, globals_1.expect)(attrs.serve_attack_shares).toEqual({ [p5.id]: 35 });
+        const back = (0, tactics_1.transformToTactics)(attrs, roster);
+        (0, globals_1.expect)(back.serveAttackShares).toEqual({ [p5.id]: 35 });
+    });
+    (0, globals_1.it)('drops a stale serve attack share key on load (lenient heal, no crash)', () => {
+        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: [p5],
+            serveAttackShares: { [p5.id]: 35 }
+        }), 'team-1');
+        attrs.libero_replacements = [];
+        const back = (0, tactics_1.transformToTactics)(attrs, roster);
+        (0, globals_1.expect)(back.serveAttackShares).toEqual({});
+    });
     (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/competition/event-rewards.d.ts

@@ -1,4 +1,4 @@
-export type EventRewardBand = 'PARTICIPATION' | 'TOP_20' | 'TOP_10' | 'TOP_5' | 'TOP_3' | 'TOP_1';
+export type EventRewardBand = 'PARTICIPATION' | 'FINAL_GROUP' | 'TOP_10' | 'TOP_5' | 'TOP_3' | 'TOP_1';
 export interface EventRewardRow {
     readonly band: EventRewardBand;
     /** Best final position that earns this row; PARTICIPATION has none. */
@@ -15,7 +15,8 @@ export interface EventRewardRow {
 export declare const EVENT_REWARDS: readonly EventRewardRow[];
 /**
  * The band a finish falls into. `position` is the place in the FINAL table; null means the team never reached
- * the final, and so does any position past the last banded row, which both count as taking part.
+ * the final (it went out in the group stage) and takes the participation row. The final holds MAX_FINAL_SIZE
+ * teams and the widest banded row (FINAL_GROUP) covers exactly that, so every finalist earns a banded row.
  */
 export declare function eventRewardBandFor(position: number | null): EventRewardBand;
 export interface EventPayout {

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

@@ -8,6 +8,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.EVENT_REWARDS = void 0;
 exports.eventRewardBandFor = eventRewardBandFor;
 exports.eventPayoutFor = eventPayoutFor;
+const event_schedule_1 = require("./event-schedule");
 /**
  * Best band first. A team earns its own row and every row BELOW it, which is what "cumulative" means: first
  * place collects all six.
@@ -17,18 +18,19 @@ exports.EVENT_REWARDS = [
     { band: 'TOP_3', maxPosition: 3, packs: 0, coins: 500 },
     { band: 'TOP_5', maxPosition: 5, packs: 0, coins: 1000 },
     { band: 'TOP_10', maxPosition: 10, packs: 1, coins: 0 },
-    { band: 'TOP_20', maxPosition: 20, packs: 0, coins: 1000 },
+    { band: 'FINAL_GROUP', maxPosition: event_schedule_1.MAX_FINAL_SIZE, packs: 0, coins: 1000 },
     { band: 'PARTICIPATION', maxPosition: null, packs: 1, coins: 1000 }
 ];
 /**
  * The band a finish falls into. `position` is the place in the FINAL table; null means the team never reached
- * the final, and so does any position past the last banded row, which both count as taking part.
+ * the final (it went out in the group stage) and takes the participation row. The final holds MAX_FINAL_SIZE
+ * teams and the widest banded row (FINAL_GROUP) covers exactly that, so every finalist earns a banded row.
  */
 function eventRewardBandFor(position) {
     if (position == null)
         return 'PARTICIPATION';
     // Rows are ordered best-first, so the FIRST row the position satisfies is the narrowest band it earns.
-    // Scanning to the end instead would always land on the widest, handing first place a "top 20" badge.
+    // Scanning to the end instead would always land on the widest, handing first place a "final group" badge.
     for (const row of exports.EVENT_REWARDS) {
         if (row.maxPosition != null && position <= row.maxPosition)
             return row.band;

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

@@ -11,11 +11,11 @@ const event_rewards_1 = require("./event-rewards");
         [5, 'TOP_5'],
         [6, 'TOP_10'],
         [10, 'TOP_10'],
-        [11, 'TOP_20'],
-        [20, 'TOP_20'],
-        // Inside a 24-team final but outside every banded row, so it counts as taking part.
-        [21, 'PARTICIPATION'],
-        [24, 'PARTICIPATION']
+        [11, 'FINAL_GROUP'],
+        [20, 'FINAL_GROUP'],
+        // The final holds 24 teams and FINAL_GROUP covers all of them.
+        [21, 'FINAL_GROUP'],
+        [24, 'FINAL_GROUP']
     ])('places a finish of %i in %s', (position, band) => {
         (0, globals_1.expect)((0, event_rewards_1.eventRewardBandFor)(position)).toBe(band);
     });
@@ -26,9 +26,9 @@ const event_rewards_1 = require("./event-rewards");
 (0, globals_1.describe)('eventPayoutFor()', () => {
     globals_1.it.each([
         // position, packs, coins. Cumulative: every row from Participation down to the finish.
-        [null, 1, 1000], // group stage: 1 pack + 1000
-        [24, 1, 1000], // in the final but outside the top 20: still just participation
-        [20, 1, 2000], // + top 20's 1000
+        [null, 1, 1000], // never reached the final (group stage): 1 pack + 1000
+        [24, 1, 2000], // last of the 24-team final: final group's 1000 on top of participation
+        [20, 1, 2000], // + final group's 1000
         [11, 1, 2000],
         [10, 2, 2000], // + top 10's pack
         [6, 2, 2000],
@@ -50,7 +50,7 @@ const event_rewards_1 = require("./event-rewards");
         }
     });
     (0, globals_1.it)('adds up to the owner-defined table for a winner', () => {
-        // 1x pack + 1000 (participation), +1000 (top 20), +1 pack (top 10), +1000 (top 5), +500 (top 3), +1 pack (top 1)
+        // 1x pack + 1000 (participation), +1000 (final group), +1 pack (top 10), +1000 (top 5), +500 (top 3), +1 pack (top 1)
         const total = event_rewards_1.EVENT_REWARDS.reduce((acc, row) => ({ packs: acc.packs + row.packs, coins: acc.coins + row.coins }), { packs: 0, coins: 0 });
         (0, globals_1.expect)((0, event_rewards_1.eventPayoutFor)(1)).toEqual(total);
         (0, globals_1.expect)(total).toEqual({ packs: 3, coins: 3500 });

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

@@ -267,6 +267,7 @@ export declare const TacticsInputSchema: z.ZodObject<{
             HIGH: "HIGH";
         }>>>;
     }, z.core.$strip>>>;
+    serveAttackShares: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodNumber>>;
     systemSets: z.ZodOptional<z.ZodArray<z.ZodObject<{
         rotationSystem: z.ZodEnum<typeof RotationSystemEnum>;
         designatedSetters: z.ZodArray<z.ZodCustom<Player, Player>>;

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

@@ -95,6 +95,11 @@ exports.TacticsInputSchema = zod_1.z.object({
     rotationSystem: zod_1.z.nativeEnum(rotation_system_1.RotationSystemEnum).default(rotation_system_1.RotationSystemEnum.SIX_ZERO),
     designatedSetters: zod_1.z.array(playerInstanceSchema).default([]),
     offensivePreferences: zod_1.z.array(offensivePreferenceSchema).default([]),
+    // Attack shares on serve (libero-serve feature): per-player attack share the sim applies when a
+    // libero-replaced player is on court unreplaced (serving, or through a libero injury). Keyed by starter id.
+    // This is NOT part of the offensivePreferences sum-to-100; its band (0-100) and libero-replacement-key rules
+    // are validated independently in the superRefine below.
+    serveAttackShares: zod_1.z.record(zod_1.z.string(), zod_1.z.number().int()).default({}),
     // Per-set overrides (5 entries, index 0 = set 1; absent => the flat fields apply to all sets). Each entry is
     // validated with the same cross-field rules as the flat fields (see superRefine below).
     systemSets: zod_1.z.array(systemSetSchema).max(5).optional(),
@@ -216,6 +221,21 @@ exports.TacticsInputSchema = zod_1.z.object({
     for (const [i, preferences] of (data.blockingPreferenceSets ?? []).entries()) {
         validateBlockingPreferences(preferences, ['blockingPreferenceSets', i]);
     }
+    // Serve attack shares (libero-serve feature): only a current libero-replacement starter (flat or per-set) may
+    // carry one, and each value must be in the 0-100 band. Validated independently of the offensive-preference
+    // sum-to-100 (a serve share never enters that total).
+    const liberoReplacementIds = new Set([
+        ...data.liberoReplacements.map(p => p.id),
+        ...(data.liberoReplacementSets ?? []).flatMap(set => set.map(p => p.id))
+    ]);
+    for (const [id, value] of Object.entries(data.serveAttackShares)) {
+        if (!liberoReplacementIds.has(id)) {
+            ctx.addIssue({ code: 'custom', message: 'SERVE_ATTACK_SHARE_NOT_A_LIBERO_REPLACEMENT', path: ['serveAttackShares'] });
+        }
+        if (value < 0 || value > 100) {
+            ctx.addIssue({ code: 'custom', message: 'SERVE_ATTACK_SHARE_OUT_OF_BAND', path: ['serveAttackShares'] });
+        }
+    }
     // Second libero (L2). The second libero is a reserve (not a starter, the libero, or a bench player). A swap
     // rule (FATIGUE/ALWAYS in any set) needs someone to swap in, so it requires a second libero, and a second
     // libero needs a starting libero to replace ("no L2 without an L"). Per-set libero replacements, like the

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

@@ -313,3 +313,83 @@ const test_helpers_1 = require("../../test-helpers");
         (0, globals_1.expect)(res.success).toBe(false);
     });
 });
+(0, globals_1.describe)('TacticsInputSchema — serve attack shares', () => {
+    const country = (0, test_helpers_1.makeCountry)();
+    const p1 = (0, test_helpers_1.makePlayer)(country);
+    const p2 = (0, test_helpers_1.makePlayer)(country);
+    const p3 = (0, test_helpers_1.makePlayer)(country);
+    const p4 = (0, test_helpers_1.makePlayer)(country);
+    const p5 = (0, test_helpers_1.makePlayer)(country);
+    const p6 = (0, test_helpers_1.makePlayer)(country);
+    const reserve = (0, test_helpers_1.makePlayer)(country);
+    // p5 sits at zone 5 (back row) and is the configured libero replacement, so it may carry a serve share.
+    function baseInput(overrides = {}) {
+        return {
+            lineup: { 4: p4, 3: p3, 2: p2, 5: p5, 6: p6, 1: p1, bench: [] },
+            liberoReplacements: [p5],
+            ...overrides
+        };
+    }
+    (0, globals_1.it)('accepts a serve share keyed by a libero replacement, value in band', () => {
+        const res = tactics_z_1.TacticsInputSchema.safeParse(baseInput({ serveAttackShares: { [p5.id]: 30 } }));
+        (0, globals_1.expect)(res.success).toBe(true);
+        if (res.success)
+            (0, globals_1.expect)(res.data.serveAttackShares[p5.id]).toBe(30);
+    });
+    (0, globals_1.it)('accepts 0 and 100 at the band edges', () => {
+        (0, globals_1.expect)(tactics_z_1.TacticsInputSchema.safeParse(baseInput({ serveAttackShares: { [p5.id]: 0 } })).success).toBe(true);
+        (0, globals_1.expect)(tactics_z_1.TacticsInputSchema.safeParse(baseInput({ serveAttackShares: { [p5.id]: 100 } })).success).toBe(true);
+    });
+    (0, globals_1.it)('rejects a serve share keyed by a starter who is not a libero replacement', () => {
+        const res = tactics_z_1.TacticsInputSchema.safeParse(baseInput({ serveAttackShares: { [p2.id]: 30 } }));
+        (0, globals_1.expect)(res.success).toBe(false);
+        if (!res.success) {
+            (0, globals_1.expect)(res.error.issues.some(i => i.message === 'SERVE_ATTACK_SHARE_NOT_A_LIBERO_REPLACEMENT')).toBe(true);
+        }
+    });
+    (0, globals_1.it)('rejects a serve share keyed by a reserve', () => {
+        const res = tactics_z_1.TacticsInputSchema.safeParse(baseInput({ serveAttackShares: { [reserve.id]: 30 } }));
+        (0, globals_1.expect)(res.success).toBe(false);
+        if (!res.success) {
+            (0, globals_1.expect)(res.error.issues.some(i => i.message === 'SERVE_ATTACK_SHARE_NOT_A_LIBERO_REPLACEMENT')).toBe(true);
+        }
+    });
+    (0, globals_1.it)('rejects an out-of-band serve share (over 100)', () => {
+        const res = tactics_z_1.TacticsInputSchema.safeParse(baseInput({ serveAttackShares: { [p5.id]: 101 } }));
+        (0, globals_1.expect)(res.success).toBe(false);
+        if (!res.success) {
+            (0, globals_1.expect)(res.error.issues.some(i => i.message === 'SERVE_ATTACK_SHARE_OUT_OF_BAND')).toBe(true);
+        }
+    });
+    (0, globals_1.it)('rejects a negative serve share', () => {
+        const res = tactics_z_1.TacticsInputSchema.safeParse(baseInput({ serveAttackShares: { [p5.id]: -1 } }));
+        (0, globals_1.expect)(res.success).toBe(false);
+        if (!res.success) {
+            (0, globals_1.expect)(res.error.issues.some(i => i.message === 'SERVE_ATTACK_SHARE_OUT_OF_BAND')).toBe(true);
+        }
+    });
+    (0, globals_1.it)('validates independently of the offensive-preference sum-to-100 (never enters that total)', () => {
+        // The other attackers' weights sum to exactly 100; the serve share on the libero replacement is separate
+        // and must not push the rotation over 100 or otherwise fail.
+        const res = tactics_z_1.TacticsInputSchema.safeParse(baseInput({
+            offensivePreferences: [{ rotation: 1, weights: { [p2.id]: 50, [p3.id]: 50 } }],
+            serveAttackShares: { [p5.id]: 40 }
+        }));
+        (0, globals_1.expect)(res.success).toBe(true);
+    });
+    (0, globals_1.it)('accepts a serve share on a per-set libero replacement', () => {
+        // p6 is a back-row starter made a libero replacement only via liberoReplacementSets.
+        const res = tactics_z_1.TacticsInputSchema.safeParse(baseInput({
+            liberoReplacements: [],
+            liberoReplacementSets: [[p6]],
+            serveAttackShares: { [p6.id]: 25 }
+        }));
+        (0, globals_1.expect)(res.success).toBe(true);
+    });
+    (0, globals_1.it)('defaults serveAttackShares to an empty map when omitted', () => {
+        const res = tactics_z_1.TacticsInputSchema.safeParse(baseInput());
+        (0, globals_1.expect)(res.success).toBe(true);
+        if (res.success)
+            (0, globals_1.expect)(res.data.serveAttackShares).toEqual({});
+    });
+});

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

@@ -275,6 +275,7 @@ export declare const TeamInputSchema: z.ZodObject<{
                 HIGH: "HIGH";
             }>>>;
         }, z.core.$strip>>>;
+        serveAttackShares: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodNumber>>;
         systemSets: z.ZodOptional<z.ZodArray<z.ZodObject<{
             rotationSystem: z.ZodEnum<typeof import("..").RotationSystemEnum>;
             designatedSetters: z.ZodArray<z.ZodCustom<Player, Player>>;

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

@@ -34,6 +34,7 @@ export interface TacticsOpts {
     readonly rotationSystem: RotationSystemEnum;
     readonly designatedSetters: Player[];
     readonly offensivePreferences: OffensivePreference[];
+    readonly serveAttackShares: Record<string, number>;
     readonly systemSets?: SystemSet[];
     readonly offensivePreferenceSets?: OffensivePreference[][];
     readonly replaceKnockedImmediately: Record<string, boolean>;
@@ -54,6 +55,7 @@ export declare class Tactics {
     readonly rotationSystem: RotationSystemEnum;
     readonly designatedSetters: Player[];
     readonly offensivePreferences: OffensivePreference[];
+    readonly serveAttackShares: Record<string, number>;
     readonly systemSets?: SystemSet[];
     readonly offensivePreferenceSets?: OffensivePreference[][];
     readonly replaceKnockedImmediately: Record<string, boolean>;

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 = [], 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 }) {
         this.lineup = lineup;
         this.liberoReplacements = liberoReplacements;
         this.receiveRotationOffset = receiveRotationOffset;
@@ -30,6 +30,7 @@ class Tactics {
         this.rotationSystem = rotationSystem;
         this.designatedSetters = designatedSetters;
         this.offensivePreferences = offensivePreferences;
+        this.serveAttackShares = serveAttackShares;
         this.systemSets = systemSets;
         this.offensivePreferenceSets = offensivePreferenceSets;
         this.replaceKnockedImmediately = replaceKnockedImmediately;

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

@@ -139,6 +139,7 @@ export interface Tactics {
     offensivePreferences: ApiOffensivePreference[];
     systemSets?: ApiSystemSet[];
     offensivePreferenceSets?: ApiOffensivePreference[][];
+    serveAttackShares?: Record<string, number>;
     blockingPreferences: ApiBlockingPreference[];
     blockingPreferenceSets?: ApiBlockingPreference[][];
     replaceKnockedImmediately?: Record<string, boolean>;

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

@@ -76,6 +76,7 @@ export interface TacticsAttributes {
     offensive_preferences: OffensivePreferenceAttributes[];
     system_sets?: SystemSetAttributes[];
     offensive_preference_sets?: OffensivePreferenceAttributes[][];
+    serve_attack_shares: Record<PlayerId, number>;
     replace_knocked_immediately?: Record<PlayerId, boolean>;
     injury_replacements?: InjuryReplacementAttributes[];
     libero_injury?: LiberoInjuryAttributes;
@@ -84,7 +85,7 @@ export interface TacticsAttributes {
 }
 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' | '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';
 export type TacticsCreationAttributes = Optional<TacticsAttributes, TacticsOptionalAttributes>;
 export declare class TacticsModel extends Model<TacticsAttributes, TacticsCreationAttributes> implements TacticsAttributes {
     team_id: string;
@@ -101,6 +102,7 @@ export declare class TacticsModel extends Model<TacticsAttributes, TacticsCreati
     offensive_preferences: OffensivePreferenceAttributes[];
     system_sets?: SystemSetAttributes[];
     offensive_preference_sets?: OffensivePreferenceAttributes[][];
+    serve_attack_shares: Record<PlayerId, number>;
     replace_knocked_immediately?: Record<PlayerId, boolean>;
     injury_replacements?: InjuryReplacementAttributes[];
     libero_injury?: LiberoInjuryAttributes;

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

@@ -72,6 +72,11 @@ export class TacticsModel extends Model {
                 type: DataTypes.JSONB,
                 allowNull: true
             },
+            serve_attack_shares: {
+                type: DataTypes.JSONB,
+                allowNull: false,
+                defaultValue: {}
+            },
             replace_knocked_immediately: {
                 type: DataTypes.JSONB,
                 allowNull: true

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

@@ -79,6 +79,7 @@ function transformToAttributes(tactics, teamId) {
             weights: p.weights,
             tempos: p.tempos
         }))),
+        serve_attack_shares: tactics.serveAttackShares ?? {},
         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,
@@ -185,6 +186,21 @@ function transformToObject(model, roster) {
             weights: p.weights,
             tempos: p.tempos
         }))),
+        // LENIENT: keep only serve shares keyed by a current libero-replacement (flat or per-set) with a value in the
+        // 0-100 band, so a stale key (a released player, or a libero-replacement config change) can never fail schema
+        // validation and crash a team load; a dropped key = no serve share.
+        serveAttackShares: (() => {
+            const liberoReplacementIds = new Set([
+                ...model.libero_replacements,
+                ...(model.libero_replacement_sets ?? []).flat()
+            ]);
+            const healed = {};
+            for (const [id, value] of Object.entries(model.serve_attack_shares ?? {})) {
+                if (liberoReplacementIds.has(id) && typeof value === 'number' && value >= 0 && value <= 100)
+                    healed[id] = value;
+            }
+            return healed;
+        })(),
         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
@@ -330,6 +346,21 @@ function tacticsColumnsToApiDto(model) {
         offensivePreferences: model.offensive_preferences,
         systemSets: model.system_sets,
         offensivePreferenceSets: model.offensive_preference_sets,
+        // Same stale-data policy as the heals below: only serve shares keyed by a current libero-replacement (flat or
+        // per-set) with a value in the 0-100 band survive; an empty map surfaces as absent so the UI never reloads and
+        // re-emits a stale key.
+        serveAttackShares: (() => {
+            const liberoReplacementIds = new Set([
+                ...model.libero_replacements,
+                ...(model.libero_replacement_sets ?? []).flat()
+            ]);
+            const healed = {};
+            for (const [id, value] of Object.entries(model.serve_attack_shares ?? {})) {
+                if (liberoReplacementIds.has(id) && typeof value === 'number' && value >= 0 && value <= 100)
+                    healed[id] = value;
+            }
+            return Object.keys(healed).length > 0 ? healed : 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
@@ -437,6 +468,7 @@ function apiTacticsConfigToAttributes(config, teamId) {
         offensive_preferences: config.offensivePreferences,
         system_sets: config.systemSets,
         offensive_preference_sets: config.offensivePreferenceSets,
+        serve_attack_shares: config.serveAttackShares ?? {},
         blocking_preferences: config.blockingPreferences ?? [],
         blocking_preference_sets: config.blockingPreferenceSets,
         replace_knocked_immediately: config.replaceKnockedImmediately,

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

@@ -141,6 +141,22 @@ describe('tacticsColumnsToApiDto()', () => {
         expect(dto.systemSets).toBeUndefined();
         expect(dto.offensivePreferenceSets).toBeUndefined();
     });
+    it('surfaces serve attack shares keyed by a libero replacement', () => {
+        const model = makeTactics([]);
+        model.serve_attack_shares = { lf: 30 }; // lf is the configured libero_replacement
+        const dto = tacticsColumnsToApiDto(model);
+        expect(dto.serveAttackShares).toEqual({ lf: 30 });
+    });
+    it('drops a serve attack share keyed by a non-libero-replacement (stale heal)', () => {
+        const model = makeTactics([]);
+        model.serve_attack_shares = { lf: 30, rf: 40 }; // rf is not in libero_replacements (['lf'])
+        const dto = tacticsColumnsToApiDto(model);
+        expect(dto.serveAttackShares).toEqual({ lf: 30 });
+    });
+    it('leaves serveAttackShares undefined when the column is empty', () => {
+        const dto = tacticsColumnsToApiDto(makeTactics([]));
+        expect(dto.serveAttackShares).toBeUndefined();
+    });
 });
 describe('per-set tactics — service <-> row round-trip', () => {
     const country = makeCountry();
@@ -188,6 +204,27 @@ describe('per-set tactics — service <-> row round-trip', () => {
         expect(back.systemSets).toBeUndefined();
         expect(back.offensivePreferenceSets).toBeUndefined();
     });
+    it('round-trips serve attack shares keyed by a libero replacement', () => {
+        const withServe = Tactics.create({
+            lineup: { 4: p4, 3: p3, 2: p2, 5: p5, 6: p6, 1: p1, bench: [] },
+            liberoReplacements: [p5],
+            serveAttackShares: { [p5.id]: 35 }
+        });
+        const attrs = transformFromTactics(withServe, 'team-1');
+        expect(attrs.serve_attack_shares).toEqual({ [p5.id]: 35 });
+        const back = transformToTactics(attrs, roster);
+        expect(back.serveAttackShares).toEqual({ [p5.id]: 35 });
+    });
+    it('drops a stale serve attack share key on load (lenient heal, no crash)', () => {
+        const attrs = transformFromTactics(Tactics.create({
+            lineup: { 4: p4, 3: p3, 2: p2, 5: p5, 6: p6, 1: p1, bench: [] },
+            liberoReplacements: [p5],
+            serveAttackShares: { [p5.id]: 35 }
+        }), 'team-1');
+        attrs.libero_replacements = [];
+        const back = transformToTactics(attrs, roster);
+        expect(back.serveAttackShares).toEqual({});
+    });
     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/competition/event-rewards.d.ts

@@ -1,4 +1,4 @@
-export type EventRewardBand = 'PARTICIPATION' | 'TOP_20' | 'TOP_10' | 'TOP_5' | 'TOP_3' | 'TOP_1';
+export type EventRewardBand = 'PARTICIPATION' | 'FINAL_GROUP' | 'TOP_10' | 'TOP_5' | 'TOP_3' | 'TOP_1';
 export interface EventRewardRow {
     readonly band: EventRewardBand;
     /** Best final position that earns this row; PARTICIPATION has none. */
@@ -15,7 +15,8 @@ export interface EventRewardRow {
 export declare const EVENT_REWARDS: readonly EventRewardRow[];
 /**
  * The band a finish falls into. `position` is the place in the FINAL table; null means the team never reached
- * the final, and so does any position past the last banded row, which both count as taking part.
+ * the final (it went out in the group stage) and takes the participation row. The final holds MAX_FINAL_SIZE
+ * teams and the widest banded row (FINAL_GROUP) covers exactly that, so every finalist earns a banded row.
  */
 export declare function eventRewardBandFor(position: number | null): EventRewardBand;
 export interface EventPayout {

package/dist/esm/src/service/competition/event-rewards.js

@@ -3,6 +3,7 @@
 // One source of truth for three consumers: the simulator grants from it, the About view lists it, and the
 // accolades page names the band. Rewards are CUMULATIVE, so a team collects every row from Participation down
 // to its own placement.
+import { MAX_FINAL_SIZE } from './event-schedule';
 /**
  * Best band first. A team earns its own row and every row BELOW it, which is what "cumulative" means: first
  * place collects all six.
@@ -12,18 +13,19 @@ export const EVENT_REWARDS = [
     { band: 'TOP_3', maxPosition: 3, packs: 0, coins: 500 },
     { band: 'TOP_5', maxPosition: 5, packs: 0, coins: 1000 },
     { band: 'TOP_10', maxPosition: 10, packs: 1, coins: 0 },
-    { band: 'TOP_20', maxPosition: 20, packs: 0, coins: 1000 },
+    { band: 'FINAL_GROUP', maxPosition: MAX_FINAL_SIZE, packs: 0, coins: 1000 },
     { band: 'PARTICIPATION', maxPosition: null, packs: 1, coins: 1000 }
 ];
 /**
  * The band a finish falls into. `position` is the place in the FINAL table; null means the team never reached
- * the final, and so does any position past the last banded row, which both count as taking part.
+ * the final (it went out in the group stage) and takes the participation row. The final holds MAX_FINAL_SIZE
+ * teams and the widest banded row (FINAL_GROUP) covers exactly that, so every finalist earns a banded row.
  */
 export function eventRewardBandFor(position) {
     if (position == null)
         return 'PARTICIPATION';
     // Rows are ordered best-first, so the FIRST row the position satisfies is the narrowest band it earns.
-    // Scanning to the end instead would always land on the widest, handing first place a "top 20" badge.
+    // Scanning to the end instead would always land on the widest, handing first place a "final group" badge.
     for (const row of EVENT_REWARDS) {
         if (row.maxPosition != null && position <= row.maxPosition)
             return row.band;

package/dist/esm/src/service/competition/event-rewards.test.js

@@ -9,11 +9,11 @@ describe('eventRewardBandFor()', () => {
         [5, 'TOP_5'],
         [6, 'TOP_10'],
         [10, 'TOP_10'],
-        [11, 'TOP_20'],
-        [20, 'TOP_20'],
-        // Inside a 24-team final but outside every banded row, so it counts as taking part.
-        [21, 'PARTICIPATION'],
-        [24, 'PARTICIPATION']
+        [11, 'FINAL_GROUP'],
+        [20, 'FINAL_GROUP'],
+        // The final holds 24 teams and FINAL_GROUP covers all of them.
+        [21, 'FINAL_GROUP'],
+        [24, 'FINAL_GROUP']
     ])('places a finish of %i in %s', (position, band) => {
         expect(eventRewardBandFor(position)).toBe(band);
     });
@@ -24,9 +24,9 @@ describe('eventRewardBandFor()', () => {
 describe('eventPayoutFor()', () => {
     it.each([
         // position, packs, coins. Cumulative: every row from Participation down to the finish.
-        [null, 1, 1000], // group stage: 1 pack + 1000
-        [24, 1, 1000], // in the final but outside the top 20: still just participation
-        [20, 1, 2000], // + top 20's 1000
+        [null, 1, 1000], // never reached the final (group stage): 1 pack + 1000
+        [24, 1, 2000], // last of the 24-team final: final group's 1000 on top of participation
+        [20, 1, 2000], // + final group's 1000
         [11, 1, 2000],
         [10, 2, 2000], // + top 10's pack
         [6, 2, 2000],
@@ -48,7 +48,7 @@ describe('eventPayoutFor()', () => {
         }
     });
     it('adds up to the owner-defined table for a winner', () => {
-        // 1x pack + 1000 (participation), +1000 (top 20), +1 pack (top 10), +1000 (top 5), +500 (top 3), +1 pack (top 1)
+        // 1x pack + 1000 (participation), +1000 (final group), +1 pack (top 10), +1000 (top 5), +500 (top 3), +1 pack (top 1)
         const total = EVENT_REWARDS.reduce((acc, row) => ({ packs: acc.packs + row.packs, coins: acc.coins + row.coins }), { packs: 0, coins: 0 });
         expect(eventPayoutFor(1)).toEqual(total);
         expect(total).toEqual({ packs: 3, coins: 3500 });

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

@@ -267,6 +267,7 @@ export declare const TacticsInputSchema: z.ZodObject<{
             HIGH: "HIGH";
         }>>>;
     }, z.core.$strip>>>;
+    serveAttackShares: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodNumber>>;
     systemSets: z.ZodOptional<z.ZodArray<z.ZodObject<{
         rotationSystem: z.ZodEnum<typeof RotationSystemEnum>;
         designatedSetters: z.ZodArray<z.ZodCustom<Player, Player>>;

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

@@ -92,6 +92,11 @@ export const TacticsInputSchema = z.object({
     rotationSystem: z.nativeEnum(RotationSystemEnum).default(RotationSystemEnum.SIX_ZERO),
     designatedSetters: z.array(playerInstanceSchema).default([]),
     offensivePreferences: z.array(offensivePreferenceSchema).default([]),
+    // Attack shares on serve (libero-serve feature): per-player attack share the sim applies when a
+    // libero-replaced player is on court unreplaced (serving, or through a libero injury). Keyed by starter id.
+    // This is NOT part of the offensivePreferences sum-to-100; its band (0-100) and libero-replacement-key rules
+    // are validated independently in the superRefine below.
+    serveAttackShares: z.record(z.string(), z.number().int()).default({}),
     // Per-set overrides (5 entries, index 0 = set 1; absent => the flat fields apply to all sets). Each entry is
     // validated with the same cross-field rules as the flat fields (see superRefine below).
     systemSets: z.array(systemSetSchema).max(5).optional(),
@@ -213,6 +218,21 @@ export const TacticsInputSchema = z.object({
     for (const [i, preferences] of (data.blockingPreferenceSets ?? []).entries()) {
         validateBlockingPreferences(preferences, ['blockingPreferenceSets', i]);
     }
+    // Serve attack shares (libero-serve feature): only a current libero-replacement starter (flat or per-set) may
+    // carry one, and each value must be in the 0-100 band. Validated independently of the offensive-preference
+    // sum-to-100 (a serve share never enters that total).
+    const liberoReplacementIds = new Set([
+        ...data.liberoReplacements.map(p => p.id),
+        ...(data.liberoReplacementSets ?? []).flatMap(set => set.map(p => p.id))
+    ]);
+    for (const [id, value] of Object.entries(data.serveAttackShares)) {
+        if (!liberoReplacementIds.has(id)) {
+            ctx.addIssue({ code: 'custom', message: 'SERVE_ATTACK_SHARE_NOT_A_LIBERO_REPLACEMENT', path: ['serveAttackShares'] });
+        }
+        if (value < 0 || value > 100) {
+            ctx.addIssue({ code: 'custom', message: 'SERVE_ATTACK_SHARE_OUT_OF_BAND', path: ['serveAttackShares'] });
+        }
+    }
     // Second libero (L2). The second libero is a reserve (not a starter, the libero, or a bench player). A swap
     // rule (FATIGUE/ALWAYS in any set) needs someone to swap in, so it requires a second libero, and a second
     // libero needs a starting libero to replace ("no L2 without an L"). Per-set libero replacements, like the

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

@@ -311,3 +311,83 @@ describe('TacticsInputSchema — blocking preferences', () => {
         expect(res.success).toBe(false);
     });
 });
+describe('TacticsInputSchema — serve attack shares', () => {
+    const country = makeCountry();
+    const p1 = makePlayer(country);
+    const p2 = makePlayer(country);
+    const p3 = makePlayer(country);
+    const p4 = makePlayer(country);
+    const p5 = makePlayer(country);
+    const p6 = makePlayer(country);
+    const reserve = makePlayer(country);
+    // p5 sits at zone 5 (back row) and is the configured libero replacement, so it may carry a serve share.
+    function baseInput(overrides = {}) {
+        return {
+            lineup: { 4: p4, 3: p3, 2: p2, 5: p5, 6: p6, 1: p1, bench: [] },
+            liberoReplacements: [p5],
+            ...overrides
+        };
+    }
+    it('accepts a serve share keyed by a libero replacement, value in band', () => {
+        const res = TacticsInputSchema.safeParse(baseInput({ serveAttackShares: { [p5.id]: 30 } }));
+        expect(res.success).toBe(true);
+        if (res.success)
+            expect(res.data.serveAttackShares[p5.id]).toBe(30);
+    });
+    it('accepts 0 and 100 at the band edges', () => {
+        expect(TacticsInputSchema.safeParse(baseInput({ serveAttackShares: { [p5.id]: 0 } })).success).toBe(true);
+        expect(TacticsInputSchema.safeParse(baseInput({ serveAttackShares: { [p5.id]: 100 } })).success).toBe(true);
+    });
+    it('rejects a serve share keyed by a starter who is not a libero replacement', () => {
+        const res = TacticsInputSchema.safeParse(baseInput({ serveAttackShares: { [p2.id]: 30 } }));
+        expect(res.success).toBe(false);
+        if (!res.success) {
+            expect(res.error.issues.some(i => i.message === 'SERVE_ATTACK_SHARE_NOT_A_LIBERO_REPLACEMENT')).toBe(true);
+        }
+    });
+    it('rejects a serve share keyed by a reserve', () => {
+        const res = TacticsInputSchema.safeParse(baseInput({ serveAttackShares: { [reserve.id]: 30 } }));
+        expect(res.success).toBe(false);
+        if (!res.success) {
+            expect(res.error.issues.some(i => i.message === 'SERVE_ATTACK_SHARE_NOT_A_LIBERO_REPLACEMENT')).toBe(true);
+        }
+    });
+    it('rejects an out-of-band serve share (over 100)', () => {
+        const res = TacticsInputSchema.safeParse(baseInput({ serveAttackShares: { [p5.id]: 101 } }));
+        expect(res.success).toBe(false);
+        if (!res.success) {
+            expect(res.error.issues.some(i => i.message === 'SERVE_ATTACK_SHARE_OUT_OF_BAND')).toBe(true);
+        }
+    });
+    it('rejects a negative serve share', () => {
+        const res = TacticsInputSchema.safeParse(baseInput({ serveAttackShares: { [p5.id]: -1 } }));
+        expect(res.success).toBe(false);
+        if (!res.success) {
+            expect(res.error.issues.some(i => i.message === 'SERVE_ATTACK_SHARE_OUT_OF_BAND')).toBe(true);
+        }
+    });
+    it('validates independently of the offensive-preference sum-to-100 (never enters that total)', () => {
+        // The other attackers' weights sum to exactly 100; the serve share on the libero replacement is separate
+        // and must not push the rotation over 100 or otherwise fail.
+        const res = TacticsInputSchema.safeParse(baseInput({
+            offensivePreferences: [{ rotation: 1, weights: { [p2.id]: 50, [p3.id]: 50 } }],
+            serveAttackShares: { [p5.id]: 40 }
+        }));
+        expect(res.success).toBe(true);
+    });
+    it('accepts a serve share on a per-set libero replacement', () => {
+        // p6 is a back-row starter made a libero replacement only via liberoReplacementSets.
+        const res = TacticsInputSchema.safeParse(baseInput({
+            liberoReplacements: [],
+            liberoReplacementSets: [[p6]],
+            serveAttackShares: { [p6.id]: 25 }
+        }));
+        expect(res.success).toBe(true);
+    });
+    it('defaults serveAttackShares to an empty map when omitted', () => {
+        const res = TacticsInputSchema.safeParse(baseInput());
+        expect(res.success).toBe(true);
+        if (res.success)
+            expect(res.data.serveAttackShares).toEqual({});
+    });
+});

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

@@ -275,6 +275,7 @@ export declare const TeamInputSchema: z.ZodObject<{
                 HIGH: "HIGH";
             }>>>;
         }, z.core.$strip>>>;
+        serveAttackShares: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodNumber>>;
         systemSets: z.ZodOptional<z.ZodArray<z.ZodObject<{
             rotationSystem: z.ZodEnum<typeof import("..").RotationSystemEnum>;
             designatedSetters: z.ZodArray<z.ZodCustom<Player, Player>>;

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

@@ -34,6 +34,7 @@ export interface TacticsOpts {
     readonly rotationSystem: RotationSystemEnum;
     readonly designatedSetters: Player[];
     readonly offensivePreferences: OffensivePreference[];
+    readonly serveAttackShares: Record<string, number>;
     readonly systemSets?: SystemSet[];
     readonly offensivePreferenceSets?: OffensivePreference[][];
     readonly replaceKnockedImmediately: Record<string, boolean>;
@@ -54,6 +55,7 @@ export declare class Tactics {
     readonly rotationSystem: RotationSystemEnum;
     readonly designatedSetters: Player[];
     readonly offensivePreferences: OffensivePreference[];
+    readonly serveAttackShares: Record<string, number>;
     readonly systemSets?: SystemSet[];
     readonly offensivePreferenceSets?: OffensivePreference[][];
     readonly replaceKnockedImmediately: Record<string, boolean>;

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 = [], 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 }) {
         this.lineup = lineup;
         this.liberoReplacements = liberoReplacements;
         this.receiveRotationOffset = receiveRotationOffset;
@@ -27,6 +27,7 @@ export class Tactics {
         this.rotationSystem = rotationSystem;
         this.designatedSetters = designatedSetters;
         this.offensivePreferences = offensivePreferences;
+        this.serveAttackShares = serveAttackShares;
         this.systemSets = systemSets;
         this.offensivePreferenceSets = offensivePreferenceSets;
         this.replaceKnockedImmediately = replaceKnockedImmediately;

package/package.json

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