volleyballsimtypes 0.0.452 → 0.0.453

package/dist/cjs/src/service/event/event-types.d.ts

@@ -1,7 +1,8 @@
 import type { BlockFailure, BlockType } from './block';
+import type { FreeBallFailure, FreeBallType } from './free-ball';
 import type { ReceptionFailure, ReceptionType } from './reception';
 import type { ServeFailure, ServeType } from './serve';
 import type { SetFailure, SetType } from './set';
 import type { SpikeFailure, SpikeType } from './spike';
-export type EventSubType = BlockType | ReceptionType | ServeType | SetType | SpikeType;
-export type EventFailureType = BlockFailure | ReceptionFailure | ServeFailure | SetFailure | SpikeFailure;
+export type EventSubType = BlockType | FreeBallType | ReceptionType | ServeType | SetType | SpikeType;
+export type EventFailureType = BlockFailure | FreeBallFailure | ReceptionFailure | ServeFailure | SetFailure | SpikeFailure;

package/dist/cjs/src/service/event/free-ball.d.ts

@@ -0,0 +1,17 @@
+import { InPlayEvent } from './in-play-event';
+export declare enum FreeBallTypeEnum {
+    OVER = 0,
+    STAY = 1
+}
+export type FreeBallType = FreeBallTypeEnum.OVER | FreeBallTypeEnum.STAY;
+export declare enum FreeBallFailureEnum {
+    NO_FAILURE = 0
+}
+export type FreeBallFailure = FreeBallFailureEnum.NO_FAILURE;
+export declare class FreeBall extends InPlayEvent<FreeBallFailure, FreeBallType> {
+    readonly failure: FreeBallFailure;
+    readonly type: FreeBallType;
+    static create(input: unknown): FreeBall;
+    private constructor();
+    toString(): string;
+}

package/dist/cjs/src/service/event/free-ball.js

@@ -0,0 +1,47 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FreeBall = exports.FreeBallFailureEnum = exports.FreeBallTypeEnum = void 0;
+const rally_event_1 = require("./rally-event");
+const in_play_event_1 = require("./in-play-event");
+const free_ball_z_1 = require("./schemas/free-ball.z");
+var FreeBallTypeEnum;
+(function (FreeBallTypeEnum) {
+    // The save sent the ball over the net as a free ball -- the opponent plays it out.
+    FreeBallTypeEnum[FreeBallTypeEnum["OVER"] = 0] = "OVER";
+    // The save kept the ball on the team's side -- the team plays out its remaining touch(es).
+    FreeBallTypeEnum[FreeBallTypeEnum["STAY"] = 1] = "STAY";
+})(FreeBallTypeEnum || (exports.FreeBallTypeEnum = FreeBallTypeEnum = {}));
+var FreeBallFailureEnum;
+(function (FreeBallFailureEnum) {
+    // A Last Resort save is guaranteed -- it always produces a free ball, never an error.
+    FreeBallFailureEnum[FreeBallFailureEnum["NO_FAILURE"] = 0] = "NO_FAILURE";
+})(FreeBallFailureEnum || (exports.FreeBallFailureEnum = FreeBallFailureEnum = {}));
+const eventType = rally_event_1.EventTypeEnum.FREE_BALL;
+// A FREE_BALL event is a Last Resort save: the libero digs a ball that would otherwise have lost the rally and
+// puts it back in play as a neutral free ball (over to the opponent, or staying on side). It is a real in-play
+// event (score + target) so the next receiver handles it like any free ball.
+class FreeBall extends in_play_event_1.InPlayEvent {
+    static create(input) {
+        const result = free_ball_z_1.FreeBallInputSchema.safeParse(input);
+        if (!result.success) {
+            throw new Error(`INVALID_FREE_BALL: ${result.error.message}. RECEIVED=${(() => { try {
+                return JSON.stringify(input);
+            }
+            catch {
+                return String(input);
+            } })()}`);
+        }
+        return new FreeBall(result.data);
+    }
+    constructor({ score, playerId, target, failure, type, activeTraits }) {
+        super({ score, playerId, target, activeTraits, eventType });
+        this.type = type;
+        this.failure = failure;
+    }
+    toString() {
+        const failure = `"failure":${this.failure}`;
+        const type = `"type":${this.type}`;
+        return `{${this._toString()},${failure},${type}}`;
+    }
+}
+exports.FreeBall = FreeBall;

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

@@ -1,5 +1,6 @@
 export * from './block';
 export * from './event-types';
+export * from './free-ball';
 export * from './in-play-event';
 export * from './libero-replacement';
 export * from './rally-event';

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

@@ -16,6 +16,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./block"), exports);
 __exportStar(require("./event-types"), exports);
+__exportStar(require("./free-ball"), exports);
 __exportStar(require("./in-play-event"), exports);
 __exportStar(require("./libero-replacement"), exports);
 __exportStar(require("./rally-event"), exports);

package/dist/cjs/src/service/event/rally-event.d.ts

@@ -5,9 +5,10 @@ export declare enum EventTypeEnum {
     RECEPTION = 3,
     SET = 4,
     SPIKE = 5,
-    BLOCK = 6
+    BLOCK = 6,
+    FREE_BALL = 7
 }
-export type EventType = EventTypeEnum.LIBERO_REPLACEMENT | EventTypeEnum.SUBSTITUTION | EventTypeEnum.SERVE | EventTypeEnum.RECEPTION | EventTypeEnum.SET | EventTypeEnum.SPIKE | EventTypeEnum.BLOCK;
+export type EventType = EventTypeEnum.LIBERO_REPLACEMENT | EventTypeEnum.SUBSTITUTION | EventTypeEnum.SERVE | EventTypeEnum.RECEPTION | EventTypeEnum.SET | EventTypeEnum.SPIKE | EventTypeEnum.BLOCK | EventTypeEnum.FREE_BALL;
 export interface RallyEventOpts {
     readonly playerId: string;
     readonly eventType: EventType;

package/dist/cjs/src/service/event/rally-event.js

@@ -10,6 +10,7 @@ var EventTypeEnum;
     EventTypeEnum[EventTypeEnum["SET"] = 4] = "SET";
     EventTypeEnum[EventTypeEnum["SPIKE"] = 5] = "SPIKE";
     EventTypeEnum[EventTypeEnum["BLOCK"] = 6] = "BLOCK";
+    EventTypeEnum[EventTypeEnum["FREE_BALL"] = 7] = "FREE_BALL";
 })(EventTypeEnum || (exports.EventTypeEnum = EventTypeEnum = {}));
 class RallyEvent {
     constructor({ eventType, playerId }) {

package/dist/cjs/src/service/event/schemas/block.z.d.ts

@@ -22,6 +22,7 @@ export declare const BlockInputSchema: z.ZodObject<{
         CRAFTY: TraitEnum.CRAFTY;
         TENACIOUS: TraitEnum.TENACIOUS;
         HUNTER: TraitEnum.HUNTER;
+        LAST_RESORT: TraitEnum.LAST_RESORT;
     }>>>;
     failure: z.ZodNumber;
     type: z.ZodNumber;

package/dist/cjs/src/service/event/schemas/free-ball.z.d.ts

@@ -0,0 +1,30 @@
+import { z } from 'zod';
+import { TraitEnum } from '../../player';
+export declare const FreeBallInputSchema: z.ZodObject<{
+    playerId: z.ZodUUID;
+    score: z.ZodNumber;
+    target: z.ZodNumber;
+    activeTraits: z.ZodDefault<z.ZodArray<z.ZodEnum<{
+        MASTER_MIND: TraitEnum.MASTER_MIND;
+        MOVING_WALL: TraitEnum.MOVING_WALL;
+        SURPRISE_ATTACK: TraitEnum.SURPRISE_ATTACK;
+        MARKSMAN: TraitEnum.MARKSMAN;
+        METEOR_SERVE: TraitEnum.METEOR_SERVE;
+        VIGOROUS: TraitEnum.VIGOROUS;
+        GUARDIAN: TraitEnum.GUARDIAN;
+        FLOAT_SERVE: TraitEnum.FLOAT_SERVE;
+        DEFENSIVE_SPECIALIST: TraitEnum.DEFENSIVE_SPECIALIST;
+        QUICK_LEARNER: TraitEnum.QUICK_LEARNER;
+        MOMENTUM_ADDICT: TraitEnum.MOMENTUM_ADDICT;
+        LOUDMOUTH: TraitEnum.LOUDMOUTH;
+        TRUE_LEADER: TraitEnum.TRUE_LEADER;
+        OVERACHIEVER: TraitEnum.OVERACHIEVER;
+        CRAFTY: TraitEnum.CRAFTY;
+        TENACIOUS: TraitEnum.TENACIOUS;
+        HUNTER: TraitEnum.HUNTER;
+        LAST_RESORT: TraitEnum.LAST_RESORT;
+    }>>>;
+    failure: z.ZodNumber;
+    type: z.ZodNumber;
+}, z.core.$strip>;
+export type FreeBallInput = z.infer<typeof FreeBallInputSchema>;

package/dist/cjs/src/service/event/schemas/free-ball.z.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FreeBallInputSchema = void 0;
+const zod_1 = require("zod");
+const player_1 = require("../../player");
+const freeBallTypeValues = [0, 1];
+const freeBallFailureValues = [0];
+const courtTargetValues = Array.from({ length: 13 }, (_, i) => i);
+exports.FreeBallInputSchema = zod_1.z.object({
+    playerId: zod_1.z.uuid(),
+    score: zod_1.z.number().finite(),
+    target: zod_1.z.number().int().refine((v) => courtTargetValues.includes(v), { message: 'INVALID_COURT_TARGET' }),
+    activeTraits: zod_1.z.array(zod_1.z.enum(Object.values(player_1.TraitEnum))).default([]),
+    failure: zod_1.z.number().int().refine((v) => freeBallFailureValues.includes(v), { message: 'INVALID_FREE_BALL_FAILURE' }),
+    type: zod_1.z.number().int().refine((v) => freeBallTypeValues.includes(v), { message: 'INVALID_FREE_BALL_TYPE' })
+});

package/dist/cjs/src/service/event/schemas/reception.z.d.ts

@@ -22,6 +22,7 @@ export declare const ReceptionInputSchema: z.ZodObject<{
         CRAFTY: TraitEnum.CRAFTY;
         TENACIOUS: TraitEnum.TENACIOUS;
         HUNTER: TraitEnum.HUNTER;
+        LAST_RESORT: TraitEnum.LAST_RESORT;
     }>>>;
     failure: z.ZodNumber;
     type: z.ZodNumber;

package/dist/cjs/src/service/event/schemas/serve.z.d.ts

@@ -22,6 +22,7 @@ export declare const ServeInputSchema: z.ZodObject<{
         CRAFTY: TraitEnum.CRAFTY;
         TENACIOUS: TraitEnum.TENACIOUS;
         HUNTER: TraitEnum.HUNTER;
+        LAST_RESORT: TraitEnum.LAST_RESORT;
     }>>>;
     failure: z.ZodNumber;
     type: z.ZodNumber;

package/dist/cjs/src/service/event/schemas/set.z.d.ts

@@ -22,6 +22,7 @@ export declare const SetInputSchema: z.ZodObject<{
         CRAFTY: TraitEnum.CRAFTY;
         TENACIOUS: TraitEnum.TENACIOUS;
         HUNTER: TraitEnum.HUNTER;
+        LAST_RESORT: TraitEnum.LAST_RESORT;
     }>>>;
     failure: z.ZodNumber;
     type: z.ZodNumber;

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

@@ -22,6 +22,7 @@ export declare const SpikeInputSchema: z.ZodObject<{
         CRAFTY: TraitEnum.CRAFTY;
         TENACIOUS: TraitEnum.TENACIOUS;
         HUNTER: TraitEnum.HUNTER;
+        LAST_RESORT: TraitEnum.LAST_RESORT;
     }>>>;
     failure: z.ZodNumber;
     type: z.ZodNumber;

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

@@ -61,6 +61,7 @@ export declare const PlayerInputSchema: z.ZodObject<{
         CRAFTY: TraitEnum.CRAFTY;
         TENACIOUS: TraitEnum.TENACIOUS;
         HUNTER: TraitEnum.HUNTER;
+        LAST_RESORT: TraitEnum.LAST_RESORT;
     }>>;
     rarity: z.ZodEnum<{
         COMMON: RarityEnum.COMMON;

package/dist/cjs/src/service/player/trait.d.ts

@@ -84,9 +84,15 @@ export declare enum TraitEnum {
      * setter, opposite, or best back-row attacker, depending on serve type and rotation), bypassing GUARDIAN,
      * with a slight serve bonus and reducing the hunted player's attack involvement that rally.
      */
-    HUNTER = "HUNTER"
+    HUNTER = "HUNTER",
+    /**
+     * Libero only. When a teammate's touch would lose the rally (a reception/dig error, a set error, or a failed
+     * dig of a blocked-back ball) and a save is still legal, a small chance the libero digs it into a neutral free
+     * ball, keeping the rally alive (over the net, or staying on side, depending on the touch).
+     */
+    LAST_RESORT = "LAST_RESORT"
 }
-export type Trait = TraitEnum.FLOAT_SERVE | TraitEnum.SURPRISE_ATTACK | TraitEnum.GUARDIAN | TraitEnum.MASTER_MIND | TraitEnum.MOVING_WALL | TraitEnum.MARKSMAN | TraitEnum.METEOR_SERVE | TraitEnum.VIGOROUS | TraitEnum.DEFENSIVE_SPECIALIST | TraitEnum.QUICK_LEARNER | TraitEnum.MOMENTUM_ADDICT | TraitEnum.LOUDMOUTH | TraitEnum.TRUE_LEADER | TraitEnum.OVERACHIEVER | TraitEnum.CRAFTY | TraitEnum.TENACIOUS | TraitEnum.HUNTER;
+export type Trait = TraitEnum.FLOAT_SERVE | TraitEnum.SURPRISE_ATTACK | TraitEnum.GUARDIAN | TraitEnum.MASTER_MIND | TraitEnum.MOVING_WALL | TraitEnum.MARKSMAN | TraitEnum.METEOR_SERVE | TraitEnum.VIGOROUS | TraitEnum.DEFENSIVE_SPECIALIST | TraitEnum.QUICK_LEARNER | TraitEnum.MOMENTUM_ADDICT | TraitEnum.LOUDMOUTH | TraitEnum.TRUE_LEADER | TraitEnum.OVERACHIEVER | TraitEnum.CRAFTY | TraitEnum.TENACIOUS | TraitEnum.HUNTER | TraitEnum.LAST_RESORT;
 export declare function assignTraits(roles: Role[], rarity: Rarity, maxTraits?: boolean): Trait[];
 export declare const traitMap: Map<Trait, TraitProps>;
 export {};

package/dist/cjs/src/service/player/trait.js

@@ -97,6 +97,12 @@ var TraitEnum;
      * with a slight serve bonus and reducing the hunted player's attack involvement that rally.
      */
     TraitEnum["HUNTER"] = "HUNTER";
+    /**
+     * Libero only. When a teammate's touch would lose the rally (a reception/dig error, a set error, or a failed
+     * dig of a blocked-back ball) and a save is still legal, a small chance the libero digs it into a neutral free
+     * ball, keeping the rally alive (over the net, or staying on side, depending on the touch).
+     */
+    TraitEnum["LAST_RESORT"] = "LAST_RESORT";
 })(TraitEnum || (exports.TraitEnum = TraitEnum = {}));
 function assignTraits(roles, rarity, maxTraits) {
     let traitCount;

package/dist/cjs/src/stat-config/traits.json

@@ -105,13 +105,12 @@
         "chance": 1,
         "roles": [
             "OUTSIDE_HITTER",
-            "OPPOSITE_HITTER",
-            "MIDDLE_BLOCKER"
+            "OPPOSITE_HITTER"
         ]
     },
     {
         "name": "LOUDMOUTH",
-        "chance": 0.25,
+        "chance": 0.3333,
         "roles": [
             "OUTSIDE_HITTER",
             "OPPOSITE_HITTER",
@@ -123,8 +122,10 @@
         "chance": 0.3,
         "roles": [
             "SETTER",
-            "LIBERO",
-            "OUTSIDE_HITTER"
+            "OUTSIDE_HITTER",
+            "OPPOSITE_HITTER",
+            "MIDDLE_BLOCKER",
+            "LIBERO"
         ]
     },
     {
@@ -132,14 +133,16 @@
         "chance": 0.2,
         "maxRarity": "MYTHIC",
         "roles": [
-            "LIBERO",
+            "SETTER",
             "OUTSIDE_HITTER",
-            "MIDDLE_BLOCKER"
+            "OPPOSITE_HITTER",
+            "MIDDLE_BLOCKER",
+            "LIBERO"
         ]
     },
     {
         "name": "CRAFTY",
-        "chance": 0.3,
+        "chance": 0.25,
         "roles": [
             "SETTER",
             "OUTSIDE_HITTER",
@@ -152,8 +155,10 @@
         "chance": 1,
         "roles": [
             "SETTER",
-            "LIBERO",
-            "OUTSIDE_HITTER"
+            "OUTSIDE_HITTER",
+            "OPPOSITE_HITTER",
+            "MIDDLE_BLOCKER",
+            "LIBERO"
         ]
     },
     {
@@ -161,8 +166,16 @@
         "chance": 0.15,
         "roles": [
             "SETTER",
+            "OUTSIDE_HITTER",
             "OPPOSITE_HITTER",
-            "OUTSIDE_HITTER"
+            "MIDDLE_BLOCKER"
+        ]
+    },
+    {
+        "name": "LAST_RESORT",
+        "chance": 0.05,
+        "roles": [
+            "LIBERO"
         ]
     }
 ]

package/dist/esm/src/service/event/event-types.d.ts

@@ -1,7 +1,8 @@
 import type { BlockFailure, BlockType } from './block';
+import type { FreeBallFailure, FreeBallType } from './free-ball';
 import type { ReceptionFailure, ReceptionType } from './reception';
 import type { ServeFailure, ServeType } from './serve';
 import type { SetFailure, SetType } from './set';
 import type { SpikeFailure, SpikeType } from './spike';
-export type EventSubType = BlockType | ReceptionType | ServeType | SetType | SpikeType;
-export type EventFailureType = BlockFailure | ReceptionFailure | ServeFailure | SetFailure | SpikeFailure;
+export type EventSubType = BlockType | FreeBallType | ReceptionType | ServeType | SetType | SpikeType;
+export type EventFailureType = BlockFailure | FreeBallFailure | ReceptionFailure | ServeFailure | SetFailure | SpikeFailure;

package/dist/esm/src/service/event/free-ball.d.ts

@@ -0,0 +1,17 @@
+import { InPlayEvent } from './in-play-event';
+export declare enum FreeBallTypeEnum {
+    OVER = 0,
+    STAY = 1
+}
+export type FreeBallType = FreeBallTypeEnum.OVER | FreeBallTypeEnum.STAY;
+export declare enum FreeBallFailureEnum {
+    NO_FAILURE = 0
+}
+export type FreeBallFailure = FreeBallFailureEnum.NO_FAILURE;
+export declare class FreeBall extends InPlayEvent<FreeBallFailure, FreeBallType> {
+    readonly failure: FreeBallFailure;
+    readonly type: FreeBallType;
+    static create(input: unknown): FreeBall;
+    private constructor();
+    toString(): string;
+}

package/dist/esm/src/service/event/free-ball.js

@@ -0,0 +1,43 @@
+import { EventTypeEnum } from './rally-event';
+import { InPlayEvent } from './in-play-event';
+import { FreeBallInputSchema } from './schemas/free-ball.z';
+export var FreeBallTypeEnum;
+(function (FreeBallTypeEnum) {
+    // The save sent the ball over the net as a free ball -- the opponent plays it out.
+    FreeBallTypeEnum[FreeBallTypeEnum["OVER"] = 0] = "OVER";
+    // The save kept the ball on the team's side -- the team plays out its remaining touch(es).
+    FreeBallTypeEnum[FreeBallTypeEnum["STAY"] = 1] = "STAY";
+})(FreeBallTypeEnum || (FreeBallTypeEnum = {}));
+export var FreeBallFailureEnum;
+(function (FreeBallFailureEnum) {
+    // A Last Resort save is guaranteed -- it always produces a free ball, never an error.
+    FreeBallFailureEnum[FreeBallFailureEnum["NO_FAILURE"] = 0] = "NO_FAILURE";
+})(FreeBallFailureEnum || (FreeBallFailureEnum = {}));
+const eventType = EventTypeEnum.FREE_BALL;
+// A FREE_BALL event is a Last Resort save: the libero digs a ball that would otherwise have lost the rally and
+// puts it back in play as a neutral free ball (over to the opponent, or staying on side). It is a real in-play
+// event (score + target) so the next receiver handles it like any free ball.
+export class FreeBall extends InPlayEvent {
+    static create(input) {
+        const result = FreeBallInputSchema.safeParse(input);
+        if (!result.success) {
+            throw new Error(`INVALID_FREE_BALL: ${result.error.message}. RECEIVED=${(() => { try {
+                return JSON.stringify(input);
+            }
+            catch {
+                return String(input);
+            } })()}`);
+        }
+        return new FreeBall(result.data);
+    }
+    constructor({ score, playerId, target, failure, type, activeTraits }) {
+        super({ score, playerId, target, activeTraits, eventType });
+        this.type = type;
+        this.failure = failure;
+    }
+    toString() {
+        const failure = `"failure":${this.failure}`;
+        const type = `"type":${this.type}`;
+        return `{${this._toString()},${failure},${type}}`;
+    }
+}

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

@@ -1,5 +1,6 @@
 export * from './block';
 export * from './event-types';
+export * from './free-ball';
 export * from './in-play-event';
 export * from './libero-replacement';
 export * from './rally-event';

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

@@ -1,5 +1,6 @@
 export * from './block';
 export * from './event-types';
+export * from './free-ball';
 export * from './in-play-event';
 export * from './libero-replacement';
 export * from './rally-event';

package/dist/esm/src/service/event/rally-event.d.ts

@@ -5,9 +5,10 @@ export declare enum EventTypeEnum {
     RECEPTION = 3,
     SET = 4,
     SPIKE = 5,
-    BLOCK = 6
+    BLOCK = 6,
+    FREE_BALL = 7
 }
-export type EventType = EventTypeEnum.LIBERO_REPLACEMENT | EventTypeEnum.SUBSTITUTION | EventTypeEnum.SERVE | EventTypeEnum.RECEPTION | EventTypeEnum.SET | EventTypeEnum.SPIKE | EventTypeEnum.BLOCK;
+export type EventType = EventTypeEnum.LIBERO_REPLACEMENT | EventTypeEnum.SUBSTITUTION | EventTypeEnum.SERVE | EventTypeEnum.RECEPTION | EventTypeEnum.SET | EventTypeEnum.SPIKE | EventTypeEnum.BLOCK | EventTypeEnum.FREE_BALL;
 export interface RallyEventOpts {
     readonly playerId: string;
     readonly eventType: EventType;

package/dist/esm/src/service/event/rally-event.js

@@ -7,6 +7,7 @@ export var EventTypeEnum;
     EventTypeEnum[EventTypeEnum["SET"] = 4] = "SET";
     EventTypeEnum[EventTypeEnum["SPIKE"] = 5] = "SPIKE";
     EventTypeEnum[EventTypeEnum["BLOCK"] = 6] = "BLOCK";
+    EventTypeEnum[EventTypeEnum["FREE_BALL"] = 7] = "FREE_BALL";
 })(EventTypeEnum || (EventTypeEnum = {}));
 export class RallyEvent {
     constructor({ eventType, playerId }) {

package/dist/esm/src/service/event/schemas/block.z.d.ts

@@ -22,6 +22,7 @@ export declare const BlockInputSchema: z.ZodObject<{
         CRAFTY: TraitEnum.CRAFTY;
         TENACIOUS: TraitEnum.TENACIOUS;
         HUNTER: TraitEnum.HUNTER;
+        LAST_RESORT: TraitEnum.LAST_RESORT;
     }>>>;
     failure: z.ZodNumber;
     type: z.ZodNumber;

package/dist/esm/src/service/event/schemas/free-ball.z.d.ts

@@ -0,0 +1,30 @@
+import { z } from 'zod';
+import { TraitEnum } from '../../player';
+export declare const FreeBallInputSchema: z.ZodObject<{
+    playerId: z.ZodUUID;
+    score: z.ZodNumber;
+    target: z.ZodNumber;
+    activeTraits: z.ZodDefault<z.ZodArray<z.ZodEnum<{
+        MASTER_MIND: TraitEnum.MASTER_MIND;
+        MOVING_WALL: TraitEnum.MOVING_WALL;
+        SURPRISE_ATTACK: TraitEnum.SURPRISE_ATTACK;
+        MARKSMAN: TraitEnum.MARKSMAN;
+        METEOR_SERVE: TraitEnum.METEOR_SERVE;
+        VIGOROUS: TraitEnum.VIGOROUS;
+        GUARDIAN: TraitEnum.GUARDIAN;
+        FLOAT_SERVE: TraitEnum.FLOAT_SERVE;
+        DEFENSIVE_SPECIALIST: TraitEnum.DEFENSIVE_SPECIALIST;
+        QUICK_LEARNER: TraitEnum.QUICK_LEARNER;
+        MOMENTUM_ADDICT: TraitEnum.MOMENTUM_ADDICT;
+        LOUDMOUTH: TraitEnum.LOUDMOUTH;
+        TRUE_LEADER: TraitEnum.TRUE_LEADER;
+        OVERACHIEVER: TraitEnum.OVERACHIEVER;
+        CRAFTY: TraitEnum.CRAFTY;
+        TENACIOUS: TraitEnum.TENACIOUS;
+        HUNTER: TraitEnum.HUNTER;
+        LAST_RESORT: TraitEnum.LAST_RESORT;
+    }>>>;
+    failure: z.ZodNumber;
+    type: z.ZodNumber;
+}, z.core.$strip>;
+export type FreeBallInput = z.infer<typeof FreeBallInputSchema>;

package/dist/esm/src/service/event/schemas/free-ball.z.js

@@ -0,0 +1,13 @@
+import { z } from 'zod';
+import { TraitEnum } from '../../player';
+const freeBallTypeValues = [0, 1];
+const freeBallFailureValues = [0];
+const courtTargetValues = Array.from({ length: 13 }, (_, i) => i);
+export const FreeBallInputSchema = z.object({
+    playerId: z.uuid(),
+    score: z.number().finite(),
+    target: z.number().int().refine((v) => courtTargetValues.includes(v), { message: 'INVALID_COURT_TARGET' }),
+    activeTraits: z.array(z.enum(Object.values(TraitEnum))).default([]),
+    failure: z.number().int().refine((v) => freeBallFailureValues.includes(v), { message: 'INVALID_FREE_BALL_FAILURE' }),
+    type: z.number().int().refine((v) => freeBallTypeValues.includes(v), { message: 'INVALID_FREE_BALL_TYPE' })
+});

package/dist/esm/src/service/event/schemas/reception.z.d.ts

@@ -22,6 +22,7 @@ export declare const ReceptionInputSchema: z.ZodObject<{
         CRAFTY: TraitEnum.CRAFTY;
         TENACIOUS: TraitEnum.TENACIOUS;
         HUNTER: TraitEnum.HUNTER;
+        LAST_RESORT: TraitEnum.LAST_RESORT;
     }>>>;
     failure: z.ZodNumber;
     type: z.ZodNumber;

package/dist/esm/src/service/event/schemas/serve.z.d.ts

@@ -22,6 +22,7 @@ export declare const ServeInputSchema: z.ZodObject<{
         CRAFTY: TraitEnum.CRAFTY;
         TENACIOUS: TraitEnum.TENACIOUS;
         HUNTER: TraitEnum.HUNTER;
+        LAST_RESORT: TraitEnum.LAST_RESORT;
     }>>>;
     failure: z.ZodNumber;
     type: z.ZodNumber;

package/dist/esm/src/service/event/schemas/set.z.d.ts

@@ -22,6 +22,7 @@ export declare const SetInputSchema: z.ZodObject<{
         CRAFTY: TraitEnum.CRAFTY;
         TENACIOUS: TraitEnum.TENACIOUS;
         HUNTER: TraitEnum.HUNTER;
+        LAST_RESORT: TraitEnum.LAST_RESORT;
     }>>>;
     failure: z.ZodNumber;
     type: z.ZodNumber;

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

@@ -22,6 +22,7 @@ export declare const SpikeInputSchema: z.ZodObject<{
         CRAFTY: TraitEnum.CRAFTY;
         TENACIOUS: TraitEnum.TENACIOUS;
         HUNTER: TraitEnum.HUNTER;
+        LAST_RESORT: TraitEnum.LAST_RESORT;
     }>>>;
     failure: z.ZodNumber;
     type: z.ZodNumber;

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

@@ -61,6 +61,7 @@ export declare const PlayerInputSchema: z.ZodObject<{
         CRAFTY: TraitEnum.CRAFTY;
         TENACIOUS: TraitEnum.TENACIOUS;
         HUNTER: TraitEnum.HUNTER;
+        LAST_RESORT: TraitEnum.LAST_RESORT;
     }>>;
     rarity: z.ZodEnum<{
         COMMON: RarityEnum.COMMON;

package/dist/esm/src/service/player/trait.d.ts

@@ -84,9 +84,15 @@ export declare enum TraitEnum {
      * setter, opposite, or best back-row attacker, depending on serve type and rotation), bypassing GUARDIAN,
      * with a slight serve bonus and reducing the hunted player's attack involvement that rally.
      */
-    HUNTER = "HUNTER"
+    HUNTER = "HUNTER",
+    /**
+     * Libero only. When a teammate's touch would lose the rally (a reception/dig error, a set error, or a failed
+     * dig of a blocked-back ball) and a save is still legal, a small chance the libero digs it into a neutral free
+     * ball, keeping the rally alive (over the net, or staying on side, depending on the touch).
+     */
+    LAST_RESORT = "LAST_RESORT"
 }
-export type Trait = TraitEnum.FLOAT_SERVE | TraitEnum.SURPRISE_ATTACK | TraitEnum.GUARDIAN | TraitEnum.MASTER_MIND | TraitEnum.MOVING_WALL | TraitEnum.MARKSMAN | TraitEnum.METEOR_SERVE | TraitEnum.VIGOROUS | TraitEnum.DEFENSIVE_SPECIALIST | TraitEnum.QUICK_LEARNER | TraitEnum.MOMENTUM_ADDICT | TraitEnum.LOUDMOUTH | TraitEnum.TRUE_LEADER | TraitEnum.OVERACHIEVER | TraitEnum.CRAFTY | TraitEnum.TENACIOUS | TraitEnum.HUNTER;
+export type Trait = TraitEnum.FLOAT_SERVE | TraitEnum.SURPRISE_ATTACK | TraitEnum.GUARDIAN | TraitEnum.MASTER_MIND | TraitEnum.MOVING_WALL | TraitEnum.MARKSMAN | TraitEnum.METEOR_SERVE | TraitEnum.VIGOROUS | TraitEnum.DEFENSIVE_SPECIALIST | TraitEnum.QUICK_LEARNER | TraitEnum.MOMENTUM_ADDICT | TraitEnum.LOUDMOUTH | TraitEnum.TRUE_LEADER | TraitEnum.OVERACHIEVER | TraitEnum.CRAFTY | TraitEnum.TENACIOUS | TraitEnum.HUNTER | TraitEnum.LAST_RESORT;
 export declare function assignTraits(roles: Role[], rarity: Rarity, maxTraits?: boolean): Trait[];
 export declare const traitMap: Map<Trait, TraitProps>;
 export {};

package/dist/esm/src/service/player/trait.js

@@ -90,6 +90,12 @@ export var TraitEnum;
      * with a slight serve bonus and reducing the hunted player's attack involvement that rally.
      */
     TraitEnum["HUNTER"] = "HUNTER";
+    /**
+     * Libero only. When a teammate's touch would lose the rally (a reception/dig error, a set error, or a failed
+     * dig of a blocked-back ball) and a save is still legal, a small chance the libero digs it into a neutral free
+     * ball, keeping the rally alive (over the net, or staying on side, depending on the touch).
+     */
+    TraitEnum["LAST_RESORT"] = "LAST_RESORT";
 })(TraitEnum || (TraitEnum = {}));
 export function assignTraits(roles, rarity, maxTraits) {
     let traitCount;

package/dist/esm/src/stat-config/traits.json

@@ -105,13 +105,12 @@
         "chance": 1,
         "roles": [
             "OUTSIDE_HITTER",
-            "OPPOSITE_HITTER",
-            "MIDDLE_BLOCKER"
+            "OPPOSITE_HITTER"
         ]
     },
     {
         "name": "LOUDMOUTH",
-        "chance": 0.25,
+        "chance": 0.3333,
         "roles": [
             "OUTSIDE_HITTER",
             "OPPOSITE_HITTER",
@@ -123,8 +122,10 @@
         "chance": 0.3,
         "roles": [
             "SETTER",
-            "LIBERO",
-            "OUTSIDE_HITTER"
+            "OUTSIDE_HITTER",
+            "OPPOSITE_HITTER",
+            "MIDDLE_BLOCKER",
+            "LIBERO"
         ]
     },
     {
@@ -132,14 +133,16 @@
         "chance": 0.2,
         "maxRarity": "MYTHIC",
         "roles": [
-            "LIBERO",
+            "SETTER",
             "OUTSIDE_HITTER",
-            "MIDDLE_BLOCKER"
+            "OPPOSITE_HITTER",
+            "MIDDLE_BLOCKER",
+            "LIBERO"
         ]
     },
     {
         "name": "CRAFTY",
-        "chance": 0.3,
+        "chance": 0.25,
         "roles": [
             "SETTER",
             "OUTSIDE_HITTER",
@@ -152,8 +155,10 @@
         "chance": 1,
         "roles": [
             "SETTER",
-            "LIBERO",
-            "OUTSIDE_HITTER"
+            "OUTSIDE_HITTER",
+            "OPPOSITE_HITTER",
+            "MIDDLE_BLOCKER",
+            "LIBERO"
         ]
     },
     {
@@ -161,8 +166,16 @@
         "chance": 0.15,
         "roles": [
             "SETTER",
+            "OUTSIDE_HITTER",
             "OPPOSITE_HITTER",
-            "OUTSIDE_HITTER"
+            "MIDDLE_BLOCKER"
+        ]
+    },
+    {
+        "name": "LAST_RESORT",
+        "chance": 0.05,
+        "roles": [
+            "LIBERO"
         ]
     }
 ]

package/package.json

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