volleyballsimtypes 0.0.474 → 0.0.476

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

@@ -111,6 +111,11 @@ export interface ApiInjuryReplacement {
     replacementId: string;
     benchBackfillId?: string;
 }
+export interface ApiLiberoInjury {
+    preMatchReplacementId?: string;
+    secondLiberoBackfillId?: string;
+    inMatchDesignateId?: string;
+}
 export interface ApiLiberoSetSubConfig {
     mode: LiberoSubMode;
     fatigueBand?: EnergyBand;
@@ -136,6 +141,7 @@ export interface Tactics {
     offensivePreferenceSets?: ApiOffensivePreference[][];
     replaceKnockedImmediately?: Record<string, boolean>;
     injuryReplacements?: ApiInjuryReplacement[];
+    liberoInjury?: ApiLiberoInjury;
 }
 export interface ApiLineupPreset {
     presetId: string;

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

@@ -44,6 +44,11 @@ export interface InjuryReplacementAttributes {
     replacementId: PlayerId;
     benchBackfillId?: PlayerId;
 }
+export interface LiberoInjuryAttributes {
+    preMatchReplacementId?: PlayerId;
+    secondLiberoBackfillId?: PlayerId;
+    inMatchDesignateId?: PlayerId;
+}
 export interface LiberoSetSubConfigAttributes {
     mode: LiberoSubMode;
     fatigueBand?: EnergyBand;
@@ -70,10 +75,11 @@ export interface TacticsAttributes {
     offensive_preference_sets?: OffensivePreferenceAttributes[][];
     replace_knocked_immediately?: Record<PlayerId, boolean>;
     injury_replacements?: InjuryReplacementAttributes[];
+    libero_injury?: LiberoInjuryAttributes;
 }
 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';
+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';
 export type TacticsCreationAttributes = Optional<TacticsAttributes, TacticsOptionalAttributes>;
 export declare class TacticsModel extends Model<TacticsAttributes, TacticsCreationAttributes> implements TacticsAttributes {
     team_id: string;
@@ -92,6 +98,7 @@ export declare class TacticsModel extends Model<TacticsAttributes, TacticsCreati
     offensive_preference_sets?: OffensivePreferenceAttributes[][];
     replace_knocked_immediately?: Record<PlayerId, boolean>;
     injury_replacements?: InjuryReplacementAttributes[];
+    libero_injury?: LiberoInjuryAttributes;
     team: TeamModel;
     getTeam: Sequelize.BelongsToGetAssociationMixin<TeamModel>;
     setTeam: Sequelize.BelongsToSetAssociationMixin<TeamModel, TeamId>;

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

@@ -82,6 +82,10 @@ class TacticsModel extends sequelize_1.Model {
             injury_replacements: {
                 type: sequelize_1.DataTypes.JSONB,
                 allowNull: true
+            },
+            libero_injury: {
+                type: sequelize_1.DataTypes.JSONB,
+                allowNull: true
             }
         }, {
             sequelize,

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

@@ -93,7 +93,14 @@ function transformToAttributes(tactics, teamId) {
             starterId: ir.starter.id,
             replacementId: ir.replacement.id,
             benchBackfillId: ir.benchBackfill?.id
-        }))
+        })),
+        libero_injury: tactics.liberoInjury != null
+            ? {
+                preMatchReplacementId: tactics.liberoInjury.preMatchReplacement?.id,
+                secondLiberoBackfillId: tactics.liberoInjury.secondLiberoBackfill?.id,
+                inMatchDesignateId: tactics.liberoInjury.inMatchDesignate?.id
+            }
+            : undefined
     };
 }
 // Accepts TacticsAttributes (not just TacticsModel) so a per-match preset's config, shaped as column data by
@@ -171,15 +178,20 @@ function transformToObject(model, roster) {
             rotation: p.rotation,
             order: p.order.map((id) => findPlayer(id, roster))
         }))),
-        // LENIENT: keep only starter-keyed boolean entries so stale jsonb (an ex-starter's key, a non-boolean
-        // value) can never fail schema validation and crash a team load; a dropped key = the ON default.
+        // LENIENT: keep only boolean entries keyed by a court starter or, when a second libero exists, the starting
+        // libero (the libero knock toggle is an L2-only feature, owner 2026-07-06) so stale jsonb (an ex-starter's
+        // key, a non-boolean value, a libero key left after the L2 was removed) can never fail schema validation
+        // and crash a team load; a dropped key = the ON default.
         replaceKnockedImmediately: (() => {
-            const starterIds = new Set([lineup[service_1.CourtPosition.LEFT_FRONT], lineup[service_1.CourtPosition.MIDDLE_FRONT], lineup[service_1.CourtPosition.RIGHT_FRONT],
+            const allowedIds = new Set([lineup[service_1.CourtPosition.LEFT_FRONT], lineup[service_1.CourtPosition.MIDDLE_FRONT], lineup[service_1.CourtPosition.RIGHT_FRONT],
                 lineup[service_1.CourtPosition.LEFT_BACK], lineup[service_1.CourtPosition.MIDDLE_BACK], lineup[service_1.CourtPosition.RIGHT_BACK]]
                 .map((p) => p.id));
+            const liberoZoneId = lineup[service_1.CourtPosition.LIBERO_ZONE]?.id;
+            if (liberoZoneId != null && secondLibero != null)
+                allowedIds.add(liberoZoneId);
             const healed = {};
             for (const [id, value] of Object.entries(model.replace_knocked_immediately ?? {})) {
-                if (starterIds.has(id) && typeof value === 'boolean')
+                if (allowedIds.has(id) && typeof value === 'boolean')
                     healed[id] = value;
             }
             return healed;
@@ -221,6 +233,38 @@ function transformToObject(model, roster) {
                 healed.push({ starter, replacement, benchBackfill });
             }
             return healed;
+        })(),
+        // LENIENT (roster.find): drop any stale/invalid libero-injury id so a bad row can never crash a team load.
+        // Mirrors the schema pool rules: preMatchReplacement is a RESERVE or the L2 (not in the lineup) and needs a
+        // starting libero; secondLiberoBackfill is a RESERVE (not the current L2) kept only when the L2 is the
+        // replacement; inMatchDesignate is a bench/reserve player (not a court starter, the libero, or the L2).
+        liberoInjury: (() => {
+            const li = model.libero_injury;
+            if (li == null)
+                return undefined;
+            const liberoZoneId = lineup[service_1.CourtPosition.LIBERO_ZONE]?.id;
+            const injuryStarterIds = new Set([lineup[service_1.CourtPosition.LEFT_FRONT], lineup[service_1.CourtPosition.MIDDLE_FRONT], lineup[service_1.CourtPosition.RIGHT_FRONT],
+                lineup[service_1.CourtPosition.LEFT_BACK], lineup[service_1.CourtPosition.MIDDLE_BACK], lineup[service_1.CourtPosition.RIGHT_BACK]]
+                .map((p) => p.id));
+            const reserveOrL2 = (id) => {
+                if (id == null)
+                    return undefined;
+                const p = roster.find((x) => x.id === id);
+                return p != null && !inLineupIds.has(p.id) ? p : undefined;
+            };
+            const preMatchReplacement = liberoZoneId != null ? reserveOrL2(li.preMatchReplacementId) : undefined;
+            const secondLiberoBackfill = (preMatchReplacement != null && preMatchReplacement.id === secondLibero?.id)
+                ? (() => { const p = reserveOrL2(li.secondLiberoBackfillId); return p != null && p.id !== secondLibero?.id ? p : undefined; })()
+                : undefined;
+            const inMatchDesignate = (() => {
+                const p = li.inMatchDesignateId != null ? roster.find((x) => x.id === li.inMatchDesignateId) : undefined;
+                if (p == null || injuryStarterIds.has(p.id) || p.id === liberoZoneId || p.id === secondLibero?.id)
+                    return undefined;
+                return p;
+            })();
+            if (preMatchReplacement == null && secondLiberoBackfill == null && inMatchDesignate == null)
+                return undefined;
+            return { preMatchReplacement, secondLiberoBackfill, inMatchDesignate };
         })()
     });
 }
@@ -282,15 +326,19 @@ 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 starter-keyed boolean entries survive, and an empty
-        // map surfaces as absent (missing key = ON).
+        // Same stale-data policy as the heals below: only boolean entries keyed by a court starter or, when a second
+        // libero exists, the starting libero (the libero knock toggle is an L2-only feature, owner 2026-07-06)
+        // survive; an empty map surfaces as absent (missing key = ON).
         replaceKnockedImmediately: (() => {
-            const starterSlotIds = new Set([model.lineup[service_1.CourtPosition.LEFT_FRONT], model.lineup[service_1.CourtPosition.MIDDLE_FRONT],
+            const allowedSlotIds = new Set([model.lineup[service_1.CourtPosition.LEFT_FRONT], model.lineup[service_1.CourtPosition.MIDDLE_FRONT],
                 model.lineup[service_1.CourtPosition.RIGHT_FRONT], model.lineup[service_1.CourtPosition.LEFT_BACK],
                 model.lineup[service_1.CourtPosition.MIDDLE_BACK], model.lineup[service_1.CourtPosition.RIGHT_BACK]]);
+            const liberoZoneId = model.lineup[service_1.CourtPosition.LIBERO_ZONE];
+            if (liberoZoneId != null && validSecondLibero != null)
+                allowedSlotIds.add(liberoZoneId);
             const healed = {};
             for (const [id, value] of Object.entries(model.replace_knocked_immediately ?? {})) {
-                if (starterSlotIds.has(id) && typeof value === 'boolean')
+                if (allowedSlotIds.has(id) && typeof value === 'boolean')
                     healed[id] = value;
             }
             return Object.keys(healed).length > 0 ? healed : undefined;
@@ -325,6 +373,30 @@ function tacticsColumnsToApiDto(model) {
                 healed.push({ starterId: ir.starterId, replacementId: ir.replacementId, benchBackfillId });
             }
             return healed.length > 0 ? healed : undefined;
+        })(),
+        // Same stale-data policy for the libero-injury ids (ids only; roster membership is checked in the service
+        // heal). preMatchReplacement = reserve or the L2 (not in the lineup) + needs a starting libero;
+        // secondLiberoBackfill = a reserve (not the current L2) kept only when the L2 is the replacement;
+        // inMatchDesignate = a bench/reserve player (not a court starter, the libero, or the L2).
+        liberoInjury: (() => {
+            const li = model.libero_injury;
+            if (li == null)
+                return undefined;
+            const liberoZoneId = model.lineup[service_1.CourtPosition.LIBERO_ZONE];
+            const starterSlotIds = new Set([model.lineup[service_1.CourtPosition.LEFT_FRONT], model.lineup[service_1.CourtPosition.MIDDLE_FRONT],
+                model.lineup[service_1.CourtPosition.RIGHT_FRONT], model.lineup[service_1.CourtPosition.LEFT_BACK],
+                model.lineup[service_1.CourtPosition.MIDDLE_BACK], model.lineup[service_1.CourtPosition.RIGHT_BACK]]);
+            const reserveOrL2 = (id) => (id != null && !lineupIds.has(id)) ? id : undefined;
+            const preMatchReplacementId = liberoZoneId != null ? reserveOrL2(li.preMatchReplacementId) : undefined;
+            const secondLiberoBackfillId = (preMatchReplacementId != null && preMatchReplacementId === validSecondLibero)
+                ? (() => { const id = reserveOrL2(li.secondLiberoBackfillId); return id != null && id !== validSecondLibero ? id : undefined; })()
+                : undefined;
+            const designateEligible = li.inMatchDesignateId != null && !starterSlotIds.has(li.inMatchDesignateId) &&
+                li.inMatchDesignateId !== liberoZoneId && li.inMatchDesignateId !== validSecondLibero;
+            const inMatchDesignateId = designateEligible ? li.inMatchDesignateId : undefined;
+            if (preMatchReplacementId == null && secondLiberoBackfillId == null && inMatchDesignateId == null)
+                return undefined;
+            return { preMatchReplacementId, secondLiberoBackfillId, inMatchDesignateId };
         })()
     };
 }
@@ -360,6 +432,7 @@ function apiTacticsConfigToAttributes(config, teamId) {
         system_sets: config.systemSets,
         offensive_preference_sets: config.offensivePreferenceSets,
         replace_knocked_immediately: config.replaceKnockedImmediately,
-        injury_replacements: config.injuryReplacements
+        injury_replacements: config.injuryReplacements,
+        libero_injury: config.liberoInjury
     };
 }

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

@@ -78,6 +78,21 @@ function makeTactics(designatedSubs) {
         (0, globals_1.expect)(dto.secondLibero).toBe('reserve1');
         (0, globals_1.expect)(dto.liberoSub).toEqual({ mode: 'FATIGUE' });
     });
+    (0, globals_1.it)('keeps a libero-keyed replaceKnockedImmediately entry when a second libero exists (L2-only feature)', () => {
+        const model = makeTactics([]);
+        model.lineup[service_1.CourtPosition.LIBERO_ZONE] = 'libero1';
+        model.second_libero = 'reserve1';
+        model.replace_knocked_immediately = { libero1: false, lf: false };
+        const dto = (0, tactics_1.tacticsColumnsToApiDto)(model);
+        (0, globals_1.expect)(dto.replaceKnockedImmediately).toEqual({ libero1: false, lf: false });
+    });
+    (0, globals_1.it)('drops a libero-keyed replaceKnockedImmediately entry when there is no second libero', () => {
+        const model = makeTactics([]);
+        model.lineup[service_1.CourtPosition.LIBERO_ZONE] = 'libero1';
+        model.replace_knocked_immediately = { libero1: false, lf: false };
+        const dto = (0, tactics_1.tacticsColumnsToApiDto)(model);
+        (0, globals_1.expect)(dto.replaceKnockedImmediately).toEqual({ lf: false });
+    });
     (0, globals_1.it)('passes per-set tactics columns through to the API DTO shape', () => {
         const model = makeTactics([]);
         model.system_sets = [{ rotationSystem: service_1.RotationSystemEnum.FIVE_ONE, designatedSetters: ['lf'] }];
@@ -139,3 +154,68 @@ function makeTactics(designatedSubs) {
         (0, globals_1.expect)(back.offensivePreferenceSets).toBeUndefined();
     });
 });
+(0, globals_1.describe)('libero injuries — service <-> row round-trip + lenient heal', () => {
+    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 libero = (0, test_helpers_1.makePlayer)(country);
+    const l2 = (0, test_helpers_1.makePlayer)(country);
+    const reserveA = (0, test_helpers_1.makePlayer)(country);
+    const reserveB = (0, test_helpers_1.makePlayer)(country);
+    const roster = [p1, p2, p3, p4, p5, p6, libero, l2, reserveA, reserveB];
+    const tactics = service_1.Tactics.create({
+        lineup: { 4: p4, 3: p3, 2: p2, 5: p5, 6: p6, 1: p1, 0: libero, bench: [] },
+        liberoReplacements: [],
+        secondLibero: l2,
+        liberoInjury: { preMatchReplacement: l2, secondLiberoBackfill: reserveA, inMatchDesignate: reserveB }
+    });
+    (0, globals_1.it)('writes libero_injury as id-based jsonb', () => {
+        const attrs = (0, tactics_1.transformFromTactics)(tactics, 'team-1');
+        (0, globals_1.expect)(attrs.libero_injury).toEqual({
+            preMatchReplacementId: l2.id,
+            secondLiberoBackfillId: reserveA.id,
+            inMatchDesignateId: reserveB.id
+        });
+    });
+    (0, globals_1.it)('resolves the stored libero_injury ids back to roster players', () => {
+        const attrs = (0, tactics_1.transformFromTactics)(tactics, 'team-1');
+        const back = (0, tactics_1.transformToTactics)(attrs, roster);
+        (0, globals_1.expect)(back.liberoInjury?.preMatchReplacement?.id).toBe(l2.id);
+        (0, globals_1.expect)(back.liberoInjury?.secondLiberoBackfill?.id).toBe(reserveA.id);
+        (0, globals_1.expect)(back.liberoInjury?.inMatchDesignate?.id).toBe(reserveB.id);
+    });
+    (0, globals_1.it)('drops a stale pre-match replacement that is now a court starter (lenient heal, no crash)', () => {
+        const attrs = (0, tactics_1.transformFromTactics)(tactics, 'team-1');
+        attrs.libero_injury.preMatchReplacementId = p2.id;
+        attrs.libero_injury.secondLiberoBackfillId = undefined;
+        const back = (0, tactics_1.transformToTactics)(attrs, roster);
+        (0, globals_1.expect)(back.liberoInjury?.preMatchReplacement).toBeUndefined();
+        (0, globals_1.expect)(back.liberoInjury?.secondLiberoBackfill).toBeUndefined();
+        (0, globals_1.expect)(back.liberoInjury?.inMatchDesignate?.id).toBe(reserveB.id);
+    });
+    (0, globals_1.it)('keeps a libero-keyed replaceKnockedImmediately entry on load when an L2 exists', () => {
+        const withKnock = service_1.Tactics.create({
+            lineup: { 4: p4, 3: p3, 2: p2, 5: p5, 6: p6, 1: p1, 0: libero, bench: [] },
+            liberoReplacements: [],
+            secondLibero: l2,
+            replaceKnockedImmediately: { [libero.id]: false, [p1.id]: false }
+        });
+        const attrs = (0, tactics_1.transformFromTactics)(withKnock, 'team-1');
+        const back = (0, tactics_1.transformToTactics)(attrs, roster);
+        (0, globals_1.expect)(back.replaceKnockedImmediately).toEqual({ [libero.id]: false, [p1.id]: false });
+    });
+    (0, globals_1.it)('drops a libero-keyed replaceKnockedImmediately entry on load when there is no L2', () => {
+        const withKnock = service_1.Tactics.create({
+            lineup: { 4: p4, 3: p3, 2: p2, 5: p5, 6: p6, 1: p1, 0: libero, bench: [] },
+            liberoReplacements: [],
+            replaceKnockedImmediately: { [libero.id]: false, [p1.id]: false }
+        });
+        const attrs = (0, tactics_1.transformFromTactics)(withKnock, 'team-1');
+        const back = (0, tactics_1.transformToTactics)(attrs, roster);
+        (0, globals_1.expect)(back.replaceKnockedImmediately).toEqual({ [p1.id]: false });
+    });
+});

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

@@ -12,3 +12,4 @@ export * from './lineup-function';
 export * from './base-position';
 export * from './offensive-preference';
 export * from './injury-replacement';
+export * from './libero-injury';

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

@@ -28,3 +28,4 @@ __exportStar(require("./lineup-function"), exports);
 __exportStar(require("./base-position"), exports);
 __exportStar(require("./offensive-preference"), exports);
 __exportStar(require("./injury-replacement"), exports);
+__exportStar(require("./libero-injury"), exports);

package/dist/cjs/src/service/team/libero-injury.d.ts

@@ -0,0 +1,6 @@
+import { Player } from '../player';
+export interface LiberoInjuryConfig {
+    readonly preMatchReplacement?: Player;
+    readonly secondLiberoBackfill?: Player;
+    readonly inMatchDesignate?: Player;
+}

package/dist/cjs/src/service/team/libero-injury.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/src/service/team/schemas/injury-replacement.z.test.js

@@ -49,8 +49,17 @@ const test_helpers_1 = require("../../test-helpers");
             (0, globals_1.expect)(res.data.replaceKnockedImmediately).toEqual({ [p1.id]: false, [p3.id]: true });
         }
     });
-    (0, globals_1.it)('rejects a replaceKnockedImmediately key that is not a court starter', () => {
-        for (const outsider of [benchA, libero, reserveA]) {
+    (0, globals_1.it)('accepts a libero-keyed replaceKnockedImmediately map', () => {
+        const res = tactics_z_1.TacticsInputSchema.safeParse(baseInput({
+            replaceKnockedImmediately: { [libero.id]: false }
+        }));
+        (0, globals_1.expect)(res.success).toBe(true);
+        if (res.success) {
+            (0, globals_1.expect)(res.data.replaceKnockedImmediately).toEqual({ [libero.id]: false });
+        }
+    });
+    (0, globals_1.it)('rejects a replaceKnockedImmediately key that is not a court starter or the libero', () => {
+        for (const outsider of [benchA, reserveA]) {
             const res = tactics_z_1.TacticsInputSchema.safeParse(baseInput({
                 replaceKnockedImmediately: { [outsider.id]: false }
             }));

package/dist/cjs/src/service/team/schemas/libero-injury.z.test.d.ts

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

package/dist/cjs/src/service/team/schemas/libero-injury.z.test.js

@@ -0,0 +1,71 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const globals_1 = require("@jest/globals");
+const tactics_z_1 = require("./tactics.z");
+const test_helpers_1 = require("../../test-helpers");
+(0, globals_1.describe)('TacticsInputSchema — liberoInjury (owner 2026-07-06)', () => {
+    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 benchA = (0, test_helpers_1.makePlayer)(country);
+    const benchB = (0, test_helpers_1.makePlayer)(country);
+    const libero = (0, test_helpers_1.makePlayer)(country);
+    const l2 = (0, test_helpers_1.makePlayer)(country); // second libero (a reserve)
+    const reserveA = (0, test_helpers_1.makePlayer)(country);
+    const reserveB = (0, test_helpers_1.makePlayer)(country);
+    function baseInput(overrides = {}) {
+        return {
+            lineup: { 4: p4, 3: p3, 2: p2, 5: p5, 6: p6, 1: p1, 0: libero, bench: [benchA, benchB] },
+            liberoReplacements: [],
+            secondLibero: l2,
+            ...overrides
+        };
+    }
+    const hasIssue = (res, message) => !res.success && res.error.issues.some(i => i.message === message);
+    (0, globals_1.it)('accepts no liberoInjury', () => {
+        (0, globals_1.expect)(tactics_z_1.TacticsInputSchema.safeParse(baseInput()).success).toBe(true);
+    });
+    (0, globals_1.it)('accepts a reserve as the pre-match libero replacement', () => {
+        (0, globals_1.expect)(tactics_z_1.TacticsInputSchema.safeParse(baseInput({ liberoInjury: { preMatchReplacement: reserveA } })).success).toBe(true);
+    });
+    (0, globals_1.it)('accepts the L2 as the replacement with a reserve backfill (new L2)', () => {
+        (0, globals_1.expect)(tactics_z_1.TacticsInputSchema.safeParse(baseInput({ liberoInjury: { preMatchReplacement: l2, secondLiberoBackfill: reserveA } })).success).toBe(true);
+    });
+    (0, globals_1.it)('rejects a starter / the libero / a bench player as the pre-match replacement', () => {
+        for (const bad of [p2, libero, benchA]) {
+            const res = tactics_z_1.TacticsInputSchema.safeParse(baseInput({ liberoInjury: { preMatchReplacement: bad } }));
+            (0, globals_1.expect)(hasIssue(res, 'LIBERO_INJURY_REPLACEMENT_MUST_BE_RESERVE_OR_L2')).toBe(true);
+        }
+    });
+    (0, globals_1.it)('rejects a pre-match replacement when there is no starting libero', () => {
+        const res = tactics_z_1.TacticsInputSchema.safeParse(baseInput({
+            lineup: { 4: p4, 3: p3, 2: p2, 5: p5, 6: p6, 1: p1, bench: [benchA, benchB] },
+            secondLibero: undefined,
+            liberoInjury: { preMatchReplacement: reserveA }
+        }));
+        (0, globals_1.expect)(hasIssue(res, 'LIBERO_INJURY_REQUIRES_LIBERO')).toBe(true);
+    });
+    (0, globals_1.it)('rejects a backfill when the replacement is not the L2', () => {
+        const res = tactics_z_1.TacticsInputSchema.safeParse(baseInput({ liberoInjury: { preMatchReplacement: reserveA, secondLiberoBackfill: reserveB } }));
+        (0, globals_1.expect)(hasIssue(res, 'LIBERO_BACKFILL_REQUIRES_L2_REPLACEMENT')).toBe(true);
+    });
+    (0, globals_1.it)('rejects a non-reserve backfill (bench player) even when the L2 is the replacement', () => {
+        const res = tactics_z_1.TacticsInputSchema.safeParse(baseInput({ liberoInjury: { preMatchReplacement: l2, secondLiberoBackfill: benchA } }));
+        (0, globals_1.expect)(hasIssue(res, 'LIBERO_BACKFILL_MUST_BE_RESERVE')).toBe(true);
+    });
+    (0, globals_1.it)('accepts a bench or reserve player as the in-match designate', () => {
+        for (const ok of [benchA, reserveA]) {
+            (0, globals_1.expect)(tactics_z_1.TacticsInputSchema.safeParse(baseInput({ liberoInjury: { inMatchDesignate: ok } })).success).toBe(true);
+        }
+    });
+    (0, globals_1.it)('rejects a starter / the libero / the L2 as the in-match designate', () => {
+        for (const bad of [p2, libero, l2]) {
+            const res = tactics_z_1.TacticsInputSchema.safeParse(baseInput({ liberoInjury: { inMatchDesignate: bad } }));
+            (0, globals_1.expect)(hasIssue(res, 'LIBERO_DESIGNATE_MUST_BE_BENCH_OR_RESERVE')).toBe(true);
+        }
+    });
+});

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

@@ -197,5 +197,10 @@ export declare const TacticsInputSchema: z.ZodObject<{
         replacement: z.ZodCustom<Player, Player>;
         benchBackfill: z.ZodOptional<z.ZodCustom<Player, Player>>;
     }, z.core.$strip>>>;
+    liberoInjury: z.ZodOptional<z.ZodObject<{
+        preMatchReplacement: z.ZodOptional<z.ZodCustom<Player, Player>>;
+        secondLiberoBackfill: z.ZodOptional<z.ZodCustom<Player, Player>>;
+        inMatchDesignate: z.ZodOptional<z.ZodCustom<Player, Player>>;
+    }, z.core.$strip>>;
 }, z.core.$strip>;
 export type TacticsInput = z.infer<typeof TacticsInputSchema>;

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

@@ -90,7 +90,17 @@ exports.TacticsInputSchema = zod_1.z.object({
         starter: playerInstanceSchema,
         replacement: playerInstanceSchema,
         benchBackfill: playerInstanceSchema.optional()
-    })).default([])
+    })).default([]),
+    // Libero injuries (owner 2026-07-06). All optional => an unconfigured team behaves exactly as before.
+    // preMatchReplacement: the reserve or the L2 that takes an already-injured starting libero's zone at match
+    // load; secondLiberoBackfill: the reserve that becomes the new L2 (only when the L2 is the replacement);
+    // inMatchDesignate: a bench/reserve player re-designated as a full libero if the sole libero goes down
+    // in-match with no L2. Cross-field pool rules are in the superRefine below.
+    liberoInjury: zod_1.z.object({
+        preMatchReplacement: playerInstanceSchema.optional(),
+        secondLiberoBackfill: playerInstanceSchema.optional(),
+        inMatchDesignate: playerInstanceSchema.optional()
+    }).optional()
 }).superRefine((data, ctx) => {
     // Cross-field rules for the rotation system. These keep an invalid config from ever reaching the sim (the
     // pinch-server outage was caused by an unvalidated tactics payload).
@@ -188,10 +198,11 @@ exports.TacticsInputSchema = zod_1.z.object({
             }
         }
     }
-    // Per-starter knock toggle: every key must be a configured court starter (bench/reserve/libero players
-    // follow the slot they occupy, so they never carry their own key).
-    for (const starterId of Object.keys(data.replaceKnockedImmediately)) {
-        if (!starterIds.has(starterId)) {
+    // Per-player knock toggle: every key must be a court starter OR the starting libero. The libero may carry its
+    // own key so the user can choose to keep a lightly knocked libero on court (owner 2026-07-06). Bench/reserve
+    // players still follow the slot they occupy, so they never carry their own key.
+    for (const knockedId of Object.keys(data.replaceKnockedImmediately)) {
+        if (!starterIds.has(knockedId) && knockedId !== libero?.id) {
             ctx.addIssue({ code: 'custom', message: 'REPLACE_KNOCKED_KEY_NOT_A_STARTER', path: ['replaceKnockedImmediately'] });
         }
     }
@@ -232,4 +243,34 @@ exports.TacticsInputSchema = zod_1.z.object({
             seenIncoming.add(ir.benchBackfill.id);
         }
     }
+    // Libero injuries (owner 2026-07-06). preMatchReplacement is a RESERVE or the L2 (never a court starter, the
+    // libero, or a bench player) and needs a starting libero to replace. secondLiberoBackfill (the new L2) is a
+    // RESERVE, valid ONLY when the L2 itself is the replacement. inMatchDesignate is a bench or reserve player NOT
+    // on court (never a court starter, the libero, or the L2).
+    const liberoInjury = data.liberoInjury;
+    if (liberoInjury != null) {
+        const preMatch = liberoInjury.preMatchReplacement;
+        const backfill = liberoInjury.secondLiberoBackfill;
+        const designate = liberoInjury.inMatchDesignate;
+        const secondLiberoId = data.secondLibero?.id;
+        if (preMatch != null) {
+            if (libero == null) {
+                ctx.addIssue({ code: 'custom', message: 'LIBERO_INJURY_REQUIRES_LIBERO', path: ['liberoInjury', 'preMatchReplacement'] });
+            }
+            if (inLineupIds.has(preMatch.id)) {
+                ctx.addIssue({ code: 'custom', message: 'LIBERO_INJURY_REPLACEMENT_MUST_BE_RESERVE_OR_L2', path: ['liberoInjury', 'preMatchReplacement'] });
+            }
+        }
+        if (backfill != null) {
+            if (preMatch == null || preMatch.id !== secondLiberoId) {
+                ctx.addIssue({ code: 'custom', message: 'LIBERO_BACKFILL_REQUIRES_L2_REPLACEMENT', path: ['liberoInjury', 'secondLiberoBackfill'] });
+            }
+            if (inLineupIds.has(backfill.id) || backfill.id === secondLiberoId) {
+                ctx.addIssue({ code: 'custom', message: 'LIBERO_BACKFILL_MUST_BE_RESERVE', path: ['liberoInjury', 'secondLiberoBackfill'] });
+            }
+        }
+        if (designate != null && (starterIds.has(designate.id) || designate.id === liberoId || designate.id === secondLiberoId)) {
+            ctx.addIssue({ code: 'custom', message: 'LIBERO_DESIGNATE_MUST_BE_BENCH_OR_RESERVE', path: ['liberoInjury', 'inMatchDesignate'] });
+        }
+    }
 });

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

@@ -205,6 +205,11 @@ export declare const TeamInputSchema: z.ZodObject<{
             replacement: z.ZodCustom<Player, Player>;
             benchBackfill: z.ZodOptional<z.ZodCustom<Player, Player>>;
         }, z.core.$strip>>>;
+        liberoInjury: z.ZodOptional<z.ZodObject<{
+            preMatchReplacement: z.ZodOptional<z.ZodCustom<Player, Player>>;
+            secondLiberoBackfill: z.ZodOptional<z.ZodCustom<Player, Player>>;
+            inMatchDesignate: z.ZodOptional<z.ZodCustom<Player, Player>>;
+        }, z.core.$strip>>;
     }, z.core.$strip>>;
 }, z.core.$strip>;
 export type TeamInput = z.infer<typeof TeamInputSchema>;

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

@@ -6,6 +6,7 @@ import { SubBand } from './energy-band';
 import { RotationSystemEnum } from './rotation-system';
 import { OffensivePreference } from './offensive-preference';
 import { InjuryReplacement } from './injury-replacement';
+import { LiberoInjuryConfig } from './libero-injury';
 export interface StartingLineup {
     readonly [CourtPosition.LEFT_FRONT]: Player;
     readonly [CourtPosition.MIDDLE_FRONT]: Player;
@@ -36,6 +37,7 @@ export interface TacticsOpts {
     readonly offensivePreferenceSets?: OffensivePreference[][];
     readonly replaceKnockedImmediately: Record<string, boolean>;
     readonly injuryReplacements: InjuryReplacement[];
+    readonly liberoInjury?: LiberoInjuryConfig;
 }
 export declare class Tactics {
     readonly lineup: StartingLineup;
@@ -53,6 +55,7 @@ export declare class Tactics {
     readonly offensivePreferenceSets?: OffensivePreference[][];
     readonly replaceKnockedImmediately: Record<string, boolean>;
     readonly injuryReplacements: InjuryReplacement[];
+    readonly liberoInjury?: LiberoInjuryConfig;
     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 = [], systemSets, offensivePreferenceSets, replaceKnockedImmediately = {}, injuryReplacements = [] }) {
+    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 }) {
         this.lineup = lineup;
         this.liberoReplacements = liberoReplacements;
         this.receiveRotationOffset = receiveRotationOffset;
@@ -34,6 +34,7 @@ class Tactics {
         this.offensivePreferenceSets = offensivePreferenceSets;
         this.replaceKnockedImmediately = replaceKnockedImmediately;
         this.injuryReplacements = injuryReplacements;
+        this.liberoInjury = liberoInjury;
     }
     findPlayerInLineup(id) {
         if (this.lineup.bench.some(p => p.id === id))

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

@@ -111,6 +111,11 @@ export interface ApiInjuryReplacement {
     replacementId: string;
     benchBackfillId?: string;
 }
+export interface ApiLiberoInjury {
+    preMatchReplacementId?: string;
+    secondLiberoBackfillId?: string;
+    inMatchDesignateId?: string;
+}
 export interface ApiLiberoSetSubConfig {
     mode: LiberoSubMode;
     fatigueBand?: EnergyBand;
@@ -136,6 +141,7 @@ export interface Tactics {
     offensivePreferenceSets?: ApiOffensivePreference[][];
     replaceKnockedImmediately?: Record<string, boolean>;
     injuryReplacements?: ApiInjuryReplacement[];
+    liberoInjury?: ApiLiberoInjury;
 }
 export interface ApiLineupPreset {
     presetId: string;

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

@@ -44,6 +44,11 @@ export interface InjuryReplacementAttributes {
     replacementId: PlayerId;
     benchBackfillId?: PlayerId;
 }
+export interface LiberoInjuryAttributes {
+    preMatchReplacementId?: PlayerId;
+    secondLiberoBackfillId?: PlayerId;
+    inMatchDesignateId?: PlayerId;
+}
 export interface LiberoSetSubConfigAttributes {
     mode: LiberoSubMode;
     fatigueBand?: EnergyBand;
@@ -70,10 +75,11 @@ export interface TacticsAttributes {
     offensive_preference_sets?: OffensivePreferenceAttributes[][];
     replace_knocked_immediately?: Record<PlayerId, boolean>;
     injury_replacements?: InjuryReplacementAttributes[];
+    libero_injury?: LiberoInjuryAttributes;
 }
 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';
+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';
 export type TacticsCreationAttributes = Optional<TacticsAttributes, TacticsOptionalAttributes>;
 export declare class TacticsModel extends Model<TacticsAttributes, TacticsCreationAttributes> implements TacticsAttributes {
     team_id: string;
@@ -92,6 +98,7 @@ export declare class TacticsModel extends Model<TacticsAttributes, TacticsCreati
     offensive_preference_sets?: OffensivePreferenceAttributes[][];
     replace_knocked_immediately?: Record<PlayerId, boolean>;
     injury_replacements?: InjuryReplacementAttributes[];
+    libero_injury?: LiberoInjuryAttributes;
     team: TeamModel;
     getTeam: Sequelize.BelongsToGetAssociationMixin<TeamModel>;
     setTeam: Sequelize.BelongsToSetAssociationMixin<TeamModel, TeamId>;

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

@@ -79,6 +79,10 @@ export class TacticsModel extends Model {
             injury_replacements: {
                 type: DataTypes.JSONB,
                 allowNull: true
+            },
+            libero_injury: {
+                type: DataTypes.JSONB,
+                allowNull: true
             }
         }, {
             sequelize,

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

@@ -87,7 +87,14 @@ function transformToAttributes(tactics, teamId) {
             starterId: ir.starter.id,
             replacementId: ir.replacement.id,
             benchBackfillId: ir.benchBackfill?.id
-        }))
+        })),
+        libero_injury: tactics.liberoInjury != null
+            ? {
+                preMatchReplacementId: tactics.liberoInjury.preMatchReplacement?.id,
+                secondLiberoBackfillId: tactics.liberoInjury.secondLiberoBackfill?.id,
+                inMatchDesignateId: tactics.liberoInjury.inMatchDesignate?.id
+            }
+            : undefined
     };
 }
 // Accepts TacticsAttributes (not just TacticsModel) so a per-match preset's config, shaped as column data by
@@ -165,15 +172,20 @@ function transformToObject(model, roster) {
             rotation: p.rotation,
             order: p.order.map((id) => findPlayer(id, roster))
         }))),
-        // LENIENT: keep only starter-keyed boolean entries so stale jsonb (an ex-starter's key, a non-boolean
-        // value) can never fail schema validation and crash a team load; a dropped key = the ON default.
+        // LENIENT: keep only boolean entries keyed by a court starter or, when a second libero exists, the starting
+        // libero (the libero knock toggle is an L2-only feature, owner 2026-07-06) so stale jsonb (an ex-starter's
+        // key, a non-boolean value, a libero key left after the L2 was removed) can never fail schema validation
+        // and crash a team load; a dropped key = the ON default.
         replaceKnockedImmediately: (() => {
-            const starterIds = new Set([lineup[CourtPosition.LEFT_FRONT], lineup[CourtPosition.MIDDLE_FRONT], lineup[CourtPosition.RIGHT_FRONT],
+            const allowedIds = new Set([lineup[CourtPosition.LEFT_FRONT], lineup[CourtPosition.MIDDLE_FRONT], lineup[CourtPosition.RIGHT_FRONT],
                 lineup[CourtPosition.LEFT_BACK], lineup[CourtPosition.MIDDLE_BACK], lineup[CourtPosition.RIGHT_BACK]]
                 .map((p) => p.id));
+            const liberoZoneId = lineup[CourtPosition.LIBERO_ZONE]?.id;
+            if (liberoZoneId != null && secondLibero != null)
+                allowedIds.add(liberoZoneId);
             const healed = {};
             for (const [id, value] of Object.entries(model.replace_knocked_immediately ?? {})) {
-                if (starterIds.has(id) && typeof value === 'boolean')
+                if (allowedIds.has(id) && typeof value === 'boolean')
                     healed[id] = value;
             }
             return healed;
@@ -215,6 +227,38 @@ function transformToObject(model, roster) {
                 healed.push({ starter, replacement, benchBackfill });
             }
             return healed;
+        })(),
+        // LENIENT (roster.find): drop any stale/invalid libero-injury id so a bad row can never crash a team load.
+        // Mirrors the schema pool rules: preMatchReplacement is a RESERVE or the L2 (not in the lineup) and needs a
+        // starting libero; secondLiberoBackfill is a RESERVE (not the current L2) kept only when the L2 is the
+        // replacement; inMatchDesignate is a bench/reserve player (not a court starter, the libero, or the L2).
+        liberoInjury: (() => {
+            const li = model.libero_injury;
+            if (li == null)
+                return undefined;
+            const liberoZoneId = lineup[CourtPosition.LIBERO_ZONE]?.id;
+            const injuryStarterIds = new Set([lineup[CourtPosition.LEFT_FRONT], lineup[CourtPosition.MIDDLE_FRONT], lineup[CourtPosition.RIGHT_FRONT],
+                lineup[CourtPosition.LEFT_BACK], lineup[CourtPosition.MIDDLE_BACK], lineup[CourtPosition.RIGHT_BACK]]
+                .map((p) => p.id));
+            const reserveOrL2 = (id) => {
+                if (id == null)
+                    return undefined;
+                const p = roster.find((x) => x.id === id);
+                return p != null && !inLineupIds.has(p.id) ? p : undefined;
+            };
+            const preMatchReplacement = liberoZoneId != null ? reserveOrL2(li.preMatchReplacementId) : undefined;
+            const secondLiberoBackfill = (preMatchReplacement != null && preMatchReplacement.id === secondLibero?.id)
+                ? (() => { const p = reserveOrL2(li.secondLiberoBackfillId); return p != null && p.id !== secondLibero?.id ? p : undefined; })()
+                : undefined;
+            const inMatchDesignate = (() => {
+                const p = li.inMatchDesignateId != null ? roster.find((x) => x.id === li.inMatchDesignateId) : undefined;
+                if (p == null || injuryStarterIds.has(p.id) || p.id === liberoZoneId || p.id === secondLibero?.id)
+                    return undefined;
+                return p;
+            })();
+            if (preMatchReplacement == null && secondLiberoBackfill == null && inMatchDesignate == null)
+                return undefined;
+            return { preMatchReplacement, secondLiberoBackfill, inMatchDesignate };
         })()
     });
 }
@@ -276,15 +320,19 @@ 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 starter-keyed boolean entries survive, and an empty
-        // map surfaces as absent (missing key = ON).
+        // Same stale-data policy as the heals below: only boolean entries keyed by a court starter or, when a second
+        // libero exists, the starting libero (the libero knock toggle is an L2-only feature, owner 2026-07-06)
+        // survive; an empty map surfaces as absent (missing key = ON).
         replaceKnockedImmediately: (() => {
-            const starterSlotIds = new Set([model.lineup[CourtPosition.LEFT_FRONT], model.lineup[CourtPosition.MIDDLE_FRONT],
+            const allowedSlotIds = new Set([model.lineup[CourtPosition.LEFT_FRONT], model.lineup[CourtPosition.MIDDLE_FRONT],
                 model.lineup[CourtPosition.RIGHT_FRONT], model.lineup[CourtPosition.LEFT_BACK],
                 model.lineup[CourtPosition.MIDDLE_BACK], model.lineup[CourtPosition.RIGHT_BACK]]);
+            const liberoZoneId = model.lineup[CourtPosition.LIBERO_ZONE];
+            if (liberoZoneId != null && validSecondLibero != null)
+                allowedSlotIds.add(liberoZoneId);
             const healed = {};
             for (const [id, value] of Object.entries(model.replace_knocked_immediately ?? {})) {
-                if (starterSlotIds.has(id) && typeof value === 'boolean')
+                if (allowedSlotIds.has(id) && typeof value === 'boolean')
                     healed[id] = value;
             }
             return Object.keys(healed).length > 0 ? healed : undefined;
@@ -319,6 +367,30 @@ function tacticsColumnsToApiDto(model) {
                 healed.push({ starterId: ir.starterId, replacementId: ir.replacementId, benchBackfillId });
             }
             return healed.length > 0 ? healed : undefined;
+        })(),
+        // Same stale-data policy for the libero-injury ids (ids only; roster membership is checked in the service
+        // heal). preMatchReplacement = reserve or the L2 (not in the lineup) + needs a starting libero;
+        // secondLiberoBackfill = a reserve (not the current L2) kept only when the L2 is the replacement;
+        // inMatchDesignate = a bench/reserve player (not a court starter, the libero, or the L2).
+        liberoInjury: (() => {
+            const li = model.libero_injury;
+            if (li == null)
+                return undefined;
+            const liberoZoneId = model.lineup[CourtPosition.LIBERO_ZONE];
+            const starterSlotIds = new Set([model.lineup[CourtPosition.LEFT_FRONT], model.lineup[CourtPosition.MIDDLE_FRONT],
+                model.lineup[CourtPosition.RIGHT_FRONT], model.lineup[CourtPosition.LEFT_BACK],
+                model.lineup[CourtPosition.MIDDLE_BACK], model.lineup[CourtPosition.RIGHT_BACK]]);
+            const reserveOrL2 = (id) => (id != null && !lineupIds.has(id)) ? id : undefined;
+            const preMatchReplacementId = liberoZoneId != null ? reserveOrL2(li.preMatchReplacementId) : undefined;
+            const secondLiberoBackfillId = (preMatchReplacementId != null && preMatchReplacementId === validSecondLibero)
+                ? (() => { const id = reserveOrL2(li.secondLiberoBackfillId); return id != null && id !== validSecondLibero ? id : undefined; })()
+                : undefined;
+            const designateEligible = li.inMatchDesignateId != null && !starterSlotIds.has(li.inMatchDesignateId) &&
+                li.inMatchDesignateId !== liberoZoneId && li.inMatchDesignateId !== validSecondLibero;
+            const inMatchDesignateId = designateEligible ? li.inMatchDesignateId : undefined;
+            if (preMatchReplacementId == null && secondLiberoBackfillId == null && inMatchDesignateId == null)
+                return undefined;
+            return { preMatchReplacementId, secondLiberoBackfillId, inMatchDesignateId };
         })()
     };
 }
@@ -354,7 +426,8 @@ function apiTacticsConfigToAttributes(config, teamId) {
         system_sets: config.systemSets,
         offensive_preference_sets: config.offensivePreferenceSets,
         replace_knocked_immediately: config.replaceKnockedImmediately,
-        injury_replacements: config.injuryReplacements
+        injury_replacements: config.injuryReplacements,
+        libero_injury: config.liberoInjury
     };
 }
 export { transformToObject as transformToTactics, transformToAttributes as transformFromTactics, tacticsColumnsToApiDto, apiTacticsConfigToAttributes as apiTacticsConfigToTacticsAttributes };

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

@@ -76,6 +76,21 @@ describe('tacticsColumnsToApiDto()', () => {
         expect(dto.secondLibero).toBe('reserve1');
         expect(dto.liberoSub).toEqual({ mode: 'FATIGUE' });
     });
+    it('keeps a libero-keyed replaceKnockedImmediately entry when a second libero exists (L2-only feature)', () => {
+        const model = makeTactics([]);
+        model.lineup[CourtPosition.LIBERO_ZONE] = 'libero1';
+        model.second_libero = 'reserve1';
+        model.replace_knocked_immediately = { libero1: false, lf: false };
+        const dto = tacticsColumnsToApiDto(model);
+        expect(dto.replaceKnockedImmediately).toEqual({ libero1: false, lf: false });
+    });
+    it('drops a libero-keyed replaceKnockedImmediately entry when there is no second libero', () => {
+        const model = makeTactics([]);
+        model.lineup[CourtPosition.LIBERO_ZONE] = 'libero1';
+        model.replace_knocked_immediately = { libero1: false, lf: false };
+        const dto = tacticsColumnsToApiDto(model);
+        expect(dto.replaceKnockedImmediately).toEqual({ lf: false });
+    });
     it('passes per-set tactics columns through to the API DTO shape', () => {
         const model = makeTactics([]);
         model.system_sets = [{ rotationSystem: RotationSystemEnum.FIVE_ONE, designatedSetters: ['lf'] }];
@@ -137,3 +152,68 @@ describe('per-set tactics — service <-> row round-trip', () => {
         expect(back.offensivePreferenceSets).toBeUndefined();
     });
 });
+describe('libero injuries — service <-> row round-trip + lenient heal', () => {
+    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 libero = makePlayer(country);
+    const l2 = makePlayer(country);
+    const reserveA = makePlayer(country);
+    const reserveB = makePlayer(country);
+    const roster = [p1, p2, p3, p4, p5, p6, libero, l2, reserveA, reserveB];
+    const tactics = Tactics.create({
+        lineup: { 4: p4, 3: p3, 2: p2, 5: p5, 6: p6, 1: p1, 0: libero, bench: [] },
+        liberoReplacements: [],
+        secondLibero: l2,
+        liberoInjury: { preMatchReplacement: l2, secondLiberoBackfill: reserveA, inMatchDesignate: reserveB }
+    });
+    it('writes libero_injury as id-based jsonb', () => {
+        const attrs = transformFromTactics(tactics, 'team-1');
+        expect(attrs.libero_injury).toEqual({
+            preMatchReplacementId: l2.id,
+            secondLiberoBackfillId: reserveA.id,
+            inMatchDesignateId: reserveB.id
+        });
+    });
+    it('resolves the stored libero_injury ids back to roster players', () => {
+        const attrs = transformFromTactics(tactics, 'team-1');
+        const back = transformToTactics(attrs, roster);
+        expect(back.liberoInjury?.preMatchReplacement?.id).toBe(l2.id);
+        expect(back.liberoInjury?.secondLiberoBackfill?.id).toBe(reserveA.id);
+        expect(back.liberoInjury?.inMatchDesignate?.id).toBe(reserveB.id);
+    });
+    it('drops a stale pre-match replacement that is now a court starter (lenient heal, no crash)', () => {
+        const attrs = transformFromTactics(tactics, 'team-1');
+        attrs.libero_injury.preMatchReplacementId = p2.id;
+        attrs.libero_injury.secondLiberoBackfillId = undefined;
+        const back = transformToTactics(attrs, roster);
+        expect(back.liberoInjury?.preMatchReplacement).toBeUndefined();
+        expect(back.liberoInjury?.secondLiberoBackfill).toBeUndefined();
+        expect(back.liberoInjury?.inMatchDesignate?.id).toBe(reserveB.id);
+    });
+    it('keeps a libero-keyed replaceKnockedImmediately entry on load when an L2 exists', () => {
+        const withKnock = Tactics.create({
+            lineup: { 4: p4, 3: p3, 2: p2, 5: p5, 6: p6, 1: p1, 0: libero, bench: [] },
+            liberoReplacements: [],
+            secondLibero: l2,
+            replaceKnockedImmediately: { [libero.id]: false, [p1.id]: false }
+        });
+        const attrs = transformFromTactics(withKnock, 'team-1');
+        const back = transformToTactics(attrs, roster);
+        expect(back.replaceKnockedImmediately).toEqual({ [libero.id]: false, [p1.id]: false });
+    });
+    it('drops a libero-keyed replaceKnockedImmediately entry on load when there is no L2', () => {
+        const withKnock = Tactics.create({
+            lineup: { 4: p4, 3: p3, 2: p2, 5: p5, 6: p6, 1: p1, 0: libero, bench: [] },
+            liberoReplacements: [],
+            replaceKnockedImmediately: { [libero.id]: false, [p1.id]: false }
+        });
+        const attrs = transformFromTactics(withKnock, 'team-1');
+        const back = transformToTactics(attrs, roster);
+        expect(back.replaceKnockedImmediately).toEqual({ [p1.id]: false });
+    });
+});

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

@@ -12,3 +12,4 @@ export * from './lineup-function';
 export * from './base-position';
 export * from './offensive-preference';
 export * from './injury-replacement';
+export * from './libero-injury';

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

@@ -12,3 +12,4 @@ export * from './lineup-function';
 export * from './base-position';
 export * from './offensive-preference';
 export * from './injury-replacement';
+export * from './libero-injury';

package/dist/esm/src/service/team/libero-injury.d.ts

@@ -0,0 +1,6 @@
+import { Player } from '../player';
+export interface LiberoInjuryConfig {
+    readonly preMatchReplacement?: Player;
+    readonly secondLiberoBackfill?: Player;
+    readonly inMatchDesignate?: Player;
+}

package/dist/esm/src/service/team/libero-injury.js

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

package/dist/esm/src/service/team/schemas/injury-replacement.z.test.js

@@ -47,8 +47,17 @@ describe('TacticsInputSchema — injuryReplacements (owner rules 2026-07-03)', (
             expect(res.data.replaceKnockedImmediately).toEqual({ [p1.id]: false, [p3.id]: true });
         }
     });
-    it('rejects a replaceKnockedImmediately key that is not a court starter', () => {
-        for (const outsider of [benchA, libero, reserveA]) {
+    it('accepts a libero-keyed replaceKnockedImmediately map', () => {
+        const res = TacticsInputSchema.safeParse(baseInput({
+            replaceKnockedImmediately: { [libero.id]: false }
+        }));
+        expect(res.success).toBe(true);
+        if (res.success) {
+            expect(res.data.replaceKnockedImmediately).toEqual({ [libero.id]: false });
+        }
+    });
+    it('rejects a replaceKnockedImmediately key that is not a court starter or the libero', () => {
+        for (const outsider of [benchA, reserveA]) {
             const res = TacticsInputSchema.safeParse(baseInput({
                 replaceKnockedImmediately: { [outsider.id]: false }
             }));

package/dist/esm/src/service/team/schemas/libero-injury.z.test.d.ts

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

package/dist/esm/src/service/team/schemas/libero-injury.z.test.js

@@ -0,0 +1,69 @@
+import { describe, it, expect } from '@jest/globals';
+import { TacticsInputSchema } from './tactics.z';
+import { makeCountry, makePlayer } from '../../test-helpers';
+describe('TacticsInputSchema — liberoInjury (owner 2026-07-06)', () => {
+    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 benchA = makePlayer(country);
+    const benchB = makePlayer(country);
+    const libero = makePlayer(country);
+    const l2 = makePlayer(country); // second libero (a reserve)
+    const reserveA = makePlayer(country);
+    const reserveB = makePlayer(country);
+    function baseInput(overrides = {}) {
+        return {
+            lineup: { 4: p4, 3: p3, 2: p2, 5: p5, 6: p6, 1: p1, 0: libero, bench: [benchA, benchB] },
+            liberoReplacements: [],
+            secondLibero: l2,
+            ...overrides
+        };
+    }
+    const hasIssue = (res, message) => !res.success && res.error.issues.some(i => i.message === message);
+    it('accepts no liberoInjury', () => {
+        expect(TacticsInputSchema.safeParse(baseInput()).success).toBe(true);
+    });
+    it('accepts a reserve as the pre-match libero replacement', () => {
+        expect(TacticsInputSchema.safeParse(baseInput({ liberoInjury: { preMatchReplacement: reserveA } })).success).toBe(true);
+    });
+    it('accepts the L2 as the replacement with a reserve backfill (new L2)', () => {
+        expect(TacticsInputSchema.safeParse(baseInput({ liberoInjury: { preMatchReplacement: l2, secondLiberoBackfill: reserveA } })).success).toBe(true);
+    });
+    it('rejects a starter / the libero / a bench player as the pre-match replacement', () => {
+        for (const bad of [p2, libero, benchA]) {
+            const res = TacticsInputSchema.safeParse(baseInput({ liberoInjury: { preMatchReplacement: bad } }));
+            expect(hasIssue(res, 'LIBERO_INJURY_REPLACEMENT_MUST_BE_RESERVE_OR_L2')).toBe(true);
+        }
+    });
+    it('rejects a pre-match replacement when there is no starting libero', () => {
+        const res = TacticsInputSchema.safeParse(baseInput({
+            lineup: { 4: p4, 3: p3, 2: p2, 5: p5, 6: p6, 1: p1, bench: [benchA, benchB] },
+            secondLibero: undefined,
+            liberoInjury: { preMatchReplacement: reserveA }
+        }));
+        expect(hasIssue(res, 'LIBERO_INJURY_REQUIRES_LIBERO')).toBe(true);
+    });
+    it('rejects a backfill when the replacement is not the L2', () => {
+        const res = TacticsInputSchema.safeParse(baseInput({ liberoInjury: { preMatchReplacement: reserveA, secondLiberoBackfill: reserveB } }));
+        expect(hasIssue(res, 'LIBERO_BACKFILL_REQUIRES_L2_REPLACEMENT')).toBe(true);
+    });
+    it('rejects a non-reserve backfill (bench player) even when the L2 is the replacement', () => {
+        const res = TacticsInputSchema.safeParse(baseInput({ liberoInjury: { preMatchReplacement: l2, secondLiberoBackfill: benchA } }));
+        expect(hasIssue(res, 'LIBERO_BACKFILL_MUST_BE_RESERVE')).toBe(true);
+    });
+    it('accepts a bench or reserve player as the in-match designate', () => {
+        for (const ok of [benchA, reserveA]) {
+            expect(TacticsInputSchema.safeParse(baseInput({ liberoInjury: { inMatchDesignate: ok } })).success).toBe(true);
+        }
+    });
+    it('rejects a starter / the libero / the L2 as the in-match designate', () => {
+        for (const bad of [p2, libero, l2]) {
+            const res = TacticsInputSchema.safeParse(baseInput({ liberoInjury: { inMatchDesignate: bad } }));
+            expect(hasIssue(res, 'LIBERO_DESIGNATE_MUST_BE_BENCH_OR_RESERVE')).toBe(true);
+        }
+    });
+});

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

@@ -197,5 +197,10 @@ export declare const TacticsInputSchema: z.ZodObject<{
         replacement: z.ZodCustom<Player, Player>;
         benchBackfill: z.ZodOptional<z.ZodCustom<Player, Player>>;
     }, z.core.$strip>>>;
+    liberoInjury: z.ZodOptional<z.ZodObject<{
+        preMatchReplacement: z.ZodOptional<z.ZodCustom<Player, Player>>;
+        secondLiberoBackfill: z.ZodOptional<z.ZodCustom<Player, Player>>;
+        inMatchDesignate: z.ZodOptional<z.ZodCustom<Player, Player>>;
+    }, z.core.$strip>>;
 }, z.core.$strip>;
 export type TacticsInput = z.infer<typeof TacticsInputSchema>;

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

@@ -87,7 +87,17 @@ export const TacticsInputSchema = z.object({
         starter: playerInstanceSchema,
         replacement: playerInstanceSchema,
         benchBackfill: playerInstanceSchema.optional()
-    })).default([])
+    })).default([]),
+    // Libero injuries (owner 2026-07-06). All optional => an unconfigured team behaves exactly as before.
+    // preMatchReplacement: the reserve or the L2 that takes an already-injured starting libero's zone at match
+    // load; secondLiberoBackfill: the reserve that becomes the new L2 (only when the L2 is the replacement);
+    // inMatchDesignate: a bench/reserve player re-designated as a full libero if the sole libero goes down
+    // in-match with no L2. Cross-field pool rules are in the superRefine below.
+    liberoInjury: z.object({
+        preMatchReplacement: playerInstanceSchema.optional(),
+        secondLiberoBackfill: playerInstanceSchema.optional(),
+        inMatchDesignate: playerInstanceSchema.optional()
+    }).optional()
 }).superRefine((data, ctx) => {
     // Cross-field rules for the rotation system. These keep an invalid config from ever reaching the sim (the
     // pinch-server outage was caused by an unvalidated tactics payload).
@@ -185,10 +195,11 @@ export const TacticsInputSchema = z.object({
             }
         }
     }
-    // Per-starter knock toggle: every key must be a configured court starter (bench/reserve/libero players
-    // follow the slot they occupy, so they never carry their own key).
-    for (const starterId of Object.keys(data.replaceKnockedImmediately)) {
-        if (!starterIds.has(starterId)) {
+    // Per-player knock toggle: every key must be a court starter OR the starting libero. The libero may carry its
+    // own key so the user can choose to keep a lightly knocked libero on court (owner 2026-07-06). Bench/reserve
+    // players still follow the slot they occupy, so they never carry their own key.
+    for (const knockedId of Object.keys(data.replaceKnockedImmediately)) {
+        if (!starterIds.has(knockedId) && knockedId !== libero?.id) {
             ctx.addIssue({ code: 'custom', message: 'REPLACE_KNOCKED_KEY_NOT_A_STARTER', path: ['replaceKnockedImmediately'] });
         }
     }
@@ -229,4 +240,34 @@ export const TacticsInputSchema = z.object({
             seenIncoming.add(ir.benchBackfill.id);
         }
     }
+    // Libero injuries (owner 2026-07-06). preMatchReplacement is a RESERVE or the L2 (never a court starter, the
+    // libero, or a bench player) and needs a starting libero to replace. secondLiberoBackfill (the new L2) is a
+    // RESERVE, valid ONLY when the L2 itself is the replacement. inMatchDesignate is a bench or reserve player NOT
+    // on court (never a court starter, the libero, or the L2).
+    const liberoInjury = data.liberoInjury;
+    if (liberoInjury != null) {
+        const preMatch = liberoInjury.preMatchReplacement;
+        const backfill = liberoInjury.secondLiberoBackfill;
+        const designate = liberoInjury.inMatchDesignate;
+        const secondLiberoId = data.secondLibero?.id;
+        if (preMatch != null) {
+            if (libero == null) {
+                ctx.addIssue({ code: 'custom', message: 'LIBERO_INJURY_REQUIRES_LIBERO', path: ['liberoInjury', 'preMatchReplacement'] });
+            }
+            if (inLineupIds.has(preMatch.id)) {
+                ctx.addIssue({ code: 'custom', message: 'LIBERO_INJURY_REPLACEMENT_MUST_BE_RESERVE_OR_L2', path: ['liberoInjury', 'preMatchReplacement'] });
+            }
+        }
+        if (backfill != null) {
+            if (preMatch == null || preMatch.id !== secondLiberoId) {
+                ctx.addIssue({ code: 'custom', message: 'LIBERO_BACKFILL_REQUIRES_L2_REPLACEMENT', path: ['liberoInjury', 'secondLiberoBackfill'] });
+            }
+            if (inLineupIds.has(backfill.id) || backfill.id === secondLiberoId) {
+                ctx.addIssue({ code: 'custom', message: 'LIBERO_BACKFILL_MUST_BE_RESERVE', path: ['liberoInjury', 'secondLiberoBackfill'] });
+            }
+        }
+        if (designate != null && (starterIds.has(designate.id) || designate.id === liberoId || designate.id === secondLiberoId)) {
+            ctx.addIssue({ code: 'custom', message: 'LIBERO_DESIGNATE_MUST_BE_BENCH_OR_RESERVE', path: ['liberoInjury', 'inMatchDesignate'] });
+        }
+    }
 });

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

@@ -205,6 +205,11 @@ export declare const TeamInputSchema: z.ZodObject<{
             replacement: z.ZodCustom<Player, Player>;
             benchBackfill: z.ZodOptional<z.ZodCustom<Player, Player>>;
         }, z.core.$strip>>>;
+        liberoInjury: z.ZodOptional<z.ZodObject<{
+            preMatchReplacement: z.ZodOptional<z.ZodCustom<Player, Player>>;
+            secondLiberoBackfill: z.ZodOptional<z.ZodCustom<Player, Player>>;
+            inMatchDesignate: z.ZodOptional<z.ZodCustom<Player, Player>>;
+        }, z.core.$strip>>;
     }, z.core.$strip>>;
 }, z.core.$strip>;
 export type TeamInput = z.infer<typeof TeamInputSchema>;

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

@@ -6,6 +6,7 @@ import { SubBand } from './energy-band';
 import { RotationSystemEnum } from './rotation-system';
 import { OffensivePreference } from './offensive-preference';
 import { InjuryReplacement } from './injury-replacement';
+import { LiberoInjuryConfig } from './libero-injury';
 export interface StartingLineup {
     readonly [CourtPosition.LEFT_FRONT]: Player;
     readonly [CourtPosition.MIDDLE_FRONT]: Player;
@@ -36,6 +37,7 @@ export interface TacticsOpts {
     readonly offensivePreferenceSets?: OffensivePreference[][];
     readonly replaceKnockedImmediately: Record<string, boolean>;
     readonly injuryReplacements: InjuryReplacement[];
+    readonly liberoInjury?: LiberoInjuryConfig;
 }
 export declare class Tactics {
     readonly lineup: StartingLineup;
@@ -53,6 +55,7 @@ export declare class Tactics {
     readonly offensivePreferenceSets?: OffensivePreference[][];
     readonly replaceKnockedImmediately: Record<string, boolean>;
     readonly injuryReplacements: InjuryReplacement[];
+    readonly liberoInjury?: LiberoInjuryConfig;
     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 = [], systemSets, offensivePreferenceSets, replaceKnockedImmediately = {}, injuryReplacements = [] }) {
+    constructor({ lineup, liberoReplacements, receiveRotationOffset = false, designatedSubs = [], substitutionBand = EnergyBand.TIRED, secondLibero, liberoSub, liberoReplacementSets, rotationSystem = RotationSystemEnum.SIX_ZERO, designatedSetters = [], offensivePreferences = [], systemSets, offensivePreferenceSets, replaceKnockedImmediately = {}, injuryReplacements = [], liberoInjury }) {
         this.lineup = lineup;
         this.liberoReplacements = liberoReplacements;
         this.receiveRotationOffset = receiveRotationOffset;
@@ -31,6 +31,7 @@ export class Tactics {
         this.offensivePreferenceSets = offensivePreferenceSets;
         this.replaceKnockedImmediately = replaceKnockedImmediately;
         this.injuryReplacements = injuryReplacements;
+        this.liberoInjury = liberoInjury;
     }
     findPlayerInLineup(id) {
         if (this.lineup.bench.some(p => p.id === id))

package/package.json

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