volleyballsimtypes 0.0.475 → 0.0.476

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

@@ -178,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;
@@ -321,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;

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'] }];
@@ -182,4 +197,25 @@ function makeTactics(designatedSubs) {
         (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/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/tactics.z.js

@@ -198,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'] });
         }
     }

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

@@ -172,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;
@@ -315,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;

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'] }];
@@ -180,4 +195,25 @@ describe('libero injuries — service <-> row round-trip + lenient heal', () =>
         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/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/tactics.z.js

@@ -195,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'] });
         }
     }

package/package.json

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