npm - volleyballsimtypes - Versions diffs - 0.0.449 → 0.0.452 - Mend

volleyballsimtypes 0.0.449 → 0.0.452

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (21) hide show

package/dist/cjs/src/data/transformers/season.js CHANGED Viewed

@@ -33,14 +33,17 @@ function transformToAttributes(season) {
     };
 }
 function transformToObject(model) {
-    const standings = model.CompetitionStandings != null && model.CompetitionStandings.length > 0
-        ? model.CompetitionStandings.map(_1.transformToStanding)
-        : undefined;
+    const teams = (0, _1.sortTeamsByCompetitionIndex)(model.Teams ?? []).map(_1.transformToTeam);
+    // One standing per roster team: the persisted CompetitionStandings aggregate where it exists, a zero-stat
+    // row otherwise. CompetitionStandings only gains a row once a team plays (the DB trigger fires on match
+    // COMPLETE), so mapping it directly dropped un-played teams from the table for the first part of a season.
+    const standingByTeam = new Map((model.CompetitionStandings ?? []).map(s => [s.team_id, (0, _1.transformToStanding)(s)]));
+    const standings = teams.map(t => standingByTeam.get(t.id) ?? service_1.Standing.create({ teamId: t.id }));
     return service_1.Season.create({
         id: model.competition_id,
         matches: (model.CompetitionMatches ?? []).map((matches) => (0, _1.transformToMatch)(matches.Match)),
         iteration: (0, _1.transformToIteration)(model.Iteration),
-        teams: (0, _1.sortTeamsByCompetitionIndex)(model.Teams ?? []).map(_1.transformToTeam),
+        teams,
         champion: model.CompetitionChampion != null ? (0, _1.transformToTeam)(model.CompetitionChampion.team) : undefined,
         status: model.status,
         divisionId: model.DivisionSeason.division_id,

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

@@ -14,6 +14,14 @@ export declare const BlockInputSchema: z.ZodObject<{
         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;
     }>>>;
     failure: z.ZodNumber;
     type: z.ZodNumber;

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

@@ -14,6 +14,14 @@ export declare const ReceptionInputSchema: z.ZodObject<{
         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;
     }>>>;
     failure: z.ZodNumber;
     type: z.ZodNumber;

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

@@ -14,6 +14,14 @@ export declare const ServeInputSchema: z.ZodObject<{
         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;
     }>>>;
     failure: z.ZodNumber;
     type: z.ZodNumber;

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

@@ -14,6 +14,14 @@ export declare const SetInputSchema: z.ZodObject<{
         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;
     }>>>;
     failure: z.ZodNumber;
     type: z.ZodNumber;

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

@@ -14,6 +14,14 @@ export declare const SpikeInputSchema: z.ZodObject<{
         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;
     }>>>;
     failure: z.ZodNumber;
     type: z.ZodNumber;

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

@@ -53,6 +53,14 @@ export declare const PlayerInputSchema: z.ZodObject<{
         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;
     }>>;
     rarity: z.ZodEnum<{
         COMMON: RarityEnum.COMMON;

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

@@ -5,6 +5,7 @@ interface TraitProps {
     readonly modifier?: number;
     readonly chance: number;
     readonly roles: Role[];
+    readonly maxRarity?: Rarity;
 }
 export declare enum TraitEnum {
     /**
@@ -45,9 +46,47 @@ export declare enum TraitEnum {
     /**
      * Gives the player a chance to perform a perfect reception.
      */
-    DEFENSIVE_SPECIALIST = "DEFENSIVE_SPECIALIST"
+    DEFENSIVE_SPECIALIST = "DEFENSIVE_SPECIALIST",
+    /**
+     * Three good receptions/digs/sets in a row make the next reception/dig/set a guaranteed critical that
+     * cannot fail.
+     */
+    QUICK_LEARNER = "QUICK_LEARNER",
+    /**
+     * Each successful attack ramps up the spike, and a kill ramps it more. Starts with a small penalty and
+     * resets on an attacking error.
+     */
+    MOMENTUM_ADDICT = "MOMENTUM_ADDICT",
+    /**
+     * A front-row kill demoralizes the opponents who faced it, debuffing them for a few rallies.
+     */
+    LOUDMOUTH = "LOUDMOUTH",
+    /**
+     * When a teammate makes a non-block mistake, that teammate's next action cannot fail.
+     */
+    TRUE_LEADER = "TRUE_LEADER",
+    /**
+     * Reacting to a strong opponent action (block/receive), this player can rise to match it. Limited to
+     * Mythic rarity and below.
+     */
+    OVERACHIEVER = "OVERACHIEVER",
+    /**
+     * Opponents who interact with this player's serve or attack spend twice the energy (VIGOROUS is nullified).
+     */
+    CRAFTY = "CRAFTY",
+    /**
+     * When the team loses several points in a row, the whole on-court team gets a buff that grows with the
+     * streak and disappears the moment they win a point.
+     */
+    TENACIOUS = "TENACIOUS",
+    /**
+     * Serve trait, rolled before the ambient setter/opposite hunt: a chance to serve a precise target (the
+     * 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"
 }
-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;
+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 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 CHANGED Viewed

@@ -10,6 +10,14 @@ const node_crypto_1 = require("node:crypto");
 const traits_json_1 = __importDefault(require("../../stat-config/traits.json"));
 const utils_1 = require("../utils");
 const traits = traits_json_1.default;
+// Ascending rarity order, used by the maxRarity trait-eligibility gate in assignTraits.
+const RARITY_RANK = {
+    [rarity_1.RarityEnum.COMMON]: 0,
+    [rarity_1.RarityEnum.RARE]: 1,
+    [rarity_1.RarityEnum.LEGENDARY]: 2,
+    [rarity_1.RarityEnum.MYTHIC]: 3,
+    [rarity_1.RarityEnum.SPECIAL]: 4
+};
 var TraitEnum;
 (function (TraitEnum) {
     /**
@@ -51,6 +59,44 @@ var TraitEnum;
      * Gives the player a chance to perform a perfect reception.
      */
     TraitEnum["DEFENSIVE_SPECIALIST"] = "DEFENSIVE_SPECIALIST";
+    /**
+     * Three good receptions/digs/sets in a row make the next reception/dig/set a guaranteed critical that
+     * cannot fail.
+     */
+    TraitEnum["QUICK_LEARNER"] = "QUICK_LEARNER";
+    /**
+     * Each successful attack ramps up the spike, and a kill ramps it more. Starts with a small penalty and
+     * resets on an attacking error.
+     */
+    TraitEnum["MOMENTUM_ADDICT"] = "MOMENTUM_ADDICT";
+    /**
+     * A front-row kill demoralizes the opponents who faced it, debuffing them for a few rallies.
+     */
+    TraitEnum["LOUDMOUTH"] = "LOUDMOUTH";
+    /**
+     * When a teammate makes a non-block mistake, that teammate's next action cannot fail.
+     */
+    TraitEnum["TRUE_LEADER"] = "TRUE_LEADER";
+    /**
+     * Reacting to a strong opponent action (block/receive), this player can rise to match it. Limited to
+     * Mythic rarity and below.
+     */
+    TraitEnum["OVERACHIEVER"] = "OVERACHIEVER";
+    /**
+     * Opponents who interact with this player's serve or attack spend twice the energy (VIGOROUS is nullified).
+     */
+    TraitEnum["CRAFTY"] = "CRAFTY";
+    /**
+     * When the team loses several points in a row, the whole on-court team gets a buff that grows with the
+     * streak and disappears the moment they win a point.
+     */
+    TraitEnum["TENACIOUS"] = "TENACIOUS";
+    /**
+     * Serve trait, rolled before the ambient setter/opposite hunt: a chance to serve a precise target (the
+     * 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.
+     */
+    TraitEnum["HUNTER"] = "HUNTER";
 })(TraitEnum || (exports.TraitEnum = TraitEnum = {}));
 function assignTraits(roles, rarity, maxTraits) {
     let traitCount;
@@ -82,7 +128,9 @@ function assignTraits(roles, rarity, maxTraits) {
         return [];
     const filteredTraits = traits.filter((trait) => {
         const setA = new Set(trait.roles);
-        return roles.some(el => setA.has(el));
+        const roleMatch = roles.some(el => setA.has(el));
+        const rarityOk = trait.maxRarity == null || RARITY_RANK[rarity] <= RARITY_RANK[trait.maxRarity];
+        return roleMatch && rarityOk;
     }).map(trait => trait.name);
     return (0, utils_1.shuffle)(filteredTraits).slice(0, traitCount);
 }

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

@@ -90,5 +90,79 @@
             "OUTSIDE_HITTER",
             "MIDDLE_BLOCKER"
         ]
+    },
+    {
+        "name": "QUICK_LEARNER",
+        "chance": 1,
+        "roles": [
+            "SETTER",
+            "LIBERO",
+            "OUTSIDE_HITTER"
+        ]
+    },
+    {
+        "name": "MOMENTUM_ADDICT",
+        "chance": 1,
+        "roles": [
+            "OUTSIDE_HITTER",
+            "OPPOSITE_HITTER",
+            "MIDDLE_BLOCKER"
+        ]
+    },
+    {
+        "name": "LOUDMOUTH",
+        "chance": 0.25,
+        "roles": [
+            "OUTSIDE_HITTER",
+            "OPPOSITE_HITTER",
+            "MIDDLE_BLOCKER"
+        ]
+    },
+    {
+        "name": "TRUE_LEADER",
+        "chance": 0.3,
+        "roles": [
+            "SETTER",
+            "LIBERO",
+            "OUTSIDE_HITTER"
+        ]
+    },
+    {
+        "name": "OVERACHIEVER",
+        "chance": 0.2,
+        "maxRarity": "MYTHIC",
+        "roles": [
+            "LIBERO",
+            "OUTSIDE_HITTER",
+            "MIDDLE_BLOCKER"
+        ]
+    },
+    {
+        "name": "CRAFTY",
+        "chance": 0.3,
+        "roles": [
+            "SETTER",
+            "OUTSIDE_HITTER",
+            "OPPOSITE_HITTER",
+            "MIDDLE_BLOCKER"
+        ]
+    },
+    {
+        "name": "TENACIOUS",
+        "chance": 1,
+        "roles": [
+            "SETTER",
+            "LIBERO",
+            "OUTSIDE_HITTER"
+        ]
+    },
+    {
+        "name": "HUNTER",
+        "chance": 0.15,
+        "roles": [
+            "SETTER",
+            "OPPOSITE_HITTER",
+            "OUTSIDE_HITTER"
+        ]
     }
 ]

package/dist/esm/src/data/transformers/season.js CHANGED Viewed

@@ -1,5 +1,5 @@
 import { sortTeamsByCompetitionIndex, transformFromSeasonMatch, transformToIteration, transformToMatch, transformToStanding, transformToTeam } from '.';
-import { Season } from '../../service';
+import { Season, Standing } from '../../service';
 function transformToAttributes(season) {
     const matches = (season.matches ?? []).map((match, index) => transformFromSeasonMatch(season.id, match, index));
     const teams = season.teams.map((team, index) => ({
@@ -29,14 +29,17 @@ function transformToAttributes(season) {
     };
 }
 function transformToObject(model) {
-    const standings = model.CompetitionStandings != null && model.CompetitionStandings.length > 0
-        ? model.CompetitionStandings.map(transformToStanding)
-        : undefined;
+    const teams = sortTeamsByCompetitionIndex(model.Teams ?? []).map(transformToTeam);
+    // One standing per roster team: the persisted CompetitionStandings aggregate where it exists, a zero-stat
+    // row otherwise. CompetitionStandings only gains a row once a team plays (the DB trigger fires on match
+    // COMPLETE), so mapping it directly dropped un-played teams from the table for the first part of a season.
+    const standingByTeam = new Map((model.CompetitionStandings ?? []).map(s => [s.team_id, transformToStanding(s)]));
+    const standings = teams.map(t => standingByTeam.get(t.id) ?? Standing.create({ teamId: t.id }));
     return Season.create({
         id: model.competition_id,
         matches: (model.CompetitionMatches ?? []).map((matches) => transformToMatch(matches.Match)),
         iteration: transformToIteration(model.Iteration),
-        teams: sortTeamsByCompetitionIndex(model.Teams ?? []).map(transformToTeam),
+        teams,
         champion: model.CompetitionChampion != null ? transformToTeam(model.CompetitionChampion.team) : undefined,
         status: model.status,
         divisionId: model.DivisionSeason.division_id,

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

@@ -14,6 +14,14 @@ export declare const BlockInputSchema: z.ZodObject<{
         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;
     }>>>;
     failure: z.ZodNumber;
     type: z.ZodNumber;

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

@@ -14,6 +14,14 @@ export declare const ReceptionInputSchema: z.ZodObject<{
         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;
     }>>>;
     failure: z.ZodNumber;
     type: z.ZodNumber;

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

@@ -14,6 +14,14 @@ export declare const ServeInputSchema: z.ZodObject<{
         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;
     }>>>;
     failure: z.ZodNumber;
     type: z.ZodNumber;

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

@@ -14,6 +14,14 @@ export declare const SetInputSchema: z.ZodObject<{
         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;
     }>>>;
     failure: z.ZodNumber;
     type: z.ZodNumber;

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

@@ -14,6 +14,14 @@ export declare const SpikeInputSchema: z.ZodObject<{
         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;
     }>>>;
     failure: z.ZodNumber;
     type: z.ZodNumber;

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

@@ -53,6 +53,14 @@ export declare const PlayerInputSchema: z.ZodObject<{
         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;
     }>>;
     rarity: z.ZodEnum<{
         COMMON: RarityEnum.COMMON;

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

@@ -5,6 +5,7 @@ interface TraitProps {
     readonly modifier?: number;
     readonly chance: number;
     readonly roles: Role[];
+    readonly maxRarity?: Rarity;
 }
 export declare enum TraitEnum {
     /**
@@ -45,9 +46,47 @@ export declare enum TraitEnum {
     /**
      * Gives the player a chance to perform a perfect reception.
      */
-    DEFENSIVE_SPECIALIST = "DEFENSIVE_SPECIALIST"
+    DEFENSIVE_SPECIALIST = "DEFENSIVE_SPECIALIST",
+    /**
+     * Three good receptions/digs/sets in a row make the next reception/dig/set a guaranteed critical that
+     * cannot fail.
+     */
+    QUICK_LEARNER = "QUICK_LEARNER",
+    /**
+     * Each successful attack ramps up the spike, and a kill ramps it more. Starts with a small penalty and
+     * resets on an attacking error.
+     */
+    MOMENTUM_ADDICT = "MOMENTUM_ADDICT",
+    /**
+     * A front-row kill demoralizes the opponents who faced it, debuffing them for a few rallies.
+     */
+    LOUDMOUTH = "LOUDMOUTH",
+    /**
+     * When a teammate makes a non-block mistake, that teammate's next action cannot fail.
+     */
+    TRUE_LEADER = "TRUE_LEADER",
+    /**
+     * Reacting to a strong opponent action (block/receive), this player can rise to match it. Limited to
+     * Mythic rarity and below.
+     */
+    OVERACHIEVER = "OVERACHIEVER",
+    /**
+     * Opponents who interact with this player's serve or attack spend twice the energy (VIGOROUS is nullified).
+     */
+    CRAFTY = "CRAFTY",
+    /**
+     * When the team loses several points in a row, the whole on-court team gets a buff that grows with the
+     * streak and disappears the moment they win a point.
+     */
+    TENACIOUS = "TENACIOUS",
+    /**
+     * Serve trait, rolled before the ambient setter/opposite hunt: a chance to serve a precise target (the
+     * 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"
 }
-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;
+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 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 CHANGED Viewed

@@ -3,6 +3,14 @@ import { randomInt } from 'node:crypto';
 import rawTraits from '../../stat-config/traits.json';
 import { shuffle } from '../utils';
 const traits = rawTraits;
+// Ascending rarity order, used by the maxRarity trait-eligibility gate in assignTraits.
+const RARITY_RANK = {
+    [RarityEnum.COMMON]: 0,
+    [RarityEnum.RARE]: 1,
+    [RarityEnum.LEGENDARY]: 2,
+    [RarityEnum.MYTHIC]: 3,
+    [RarityEnum.SPECIAL]: 4
+};
 export var TraitEnum;
 (function (TraitEnum) {
     /**
@@ -44,6 +52,44 @@ export var TraitEnum;
      * Gives the player a chance to perform a perfect reception.
      */
     TraitEnum["DEFENSIVE_SPECIALIST"] = "DEFENSIVE_SPECIALIST";
+    /**
+     * Three good receptions/digs/sets in a row make the next reception/dig/set a guaranteed critical that
+     * cannot fail.
+     */
+    TraitEnum["QUICK_LEARNER"] = "QUICK_LEARNER";
+    /**
+     * Each successful attack ramps up the spike, and a kill ramps it more. Starts with a small penalty and
+     * resets on an attacking error.
+     */
+    TraitEnum["MOMENTUM_ADDICT"] = "MOMENTUM_ADDICT";
+    /**
+     * A front-row kill demoralizes the opponents who faced it, debuffing them for a few rallies.
+     */
+    TraitEnum["LOUDMOUTH"] = "LOUDMOUTH";
+    /**
+     * When a teammate makes a non-block mistake, that teammate's next action cannot fail.
+     */
+    TraitEnum["TRUE_LEADER"] = "TRUE_LEADER";
+    /**
+     * Reacting to a strong opponent action (block/receive), this player can rise to match it. Limited to
+     * Mythic rarity and below.
+     */
+    TraitEnum["OVERACHIEVER"] = "OVERACHIEVER";
+    /**
+     * Opponents who interact with this player's serve or attack spend twice the energy (VIGOROUS is nullified).
+     */
+    TraitEnum["CRAFTY"] = "CRAFTY";
+    /**
+     * When the team loses several points in a row, the whole on-court team gets a buff that grows with the
+     * streak and disappears the moment they win a point.
+     */
+    TraitEnum["TENACIOUS"] = "TENACIOUS";
+    /**
+     * Serve trait, rolled before the ambient setter/opposite hunt: a chance to serve a precise target (the
+     * 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.
+     */
+    TraitEnum["HUNTER"] = "HUNTER";
 })(TraitEnum || (TraitEnum = {}));
 export function assignTraits(roles, rarity, maxTraits) {
     let traitCount;
@@ -75,7 +121,9 @@ export function assignTraits(roles, rarity, maxTraits) {
         return [];
     const filteredTraits = traits.filter((trait) => {
         const setA = new Set(trait.roles);
-        return roles.some(el => setA.has(el));
+        const roleMatch = roles.some(el => setA.has(el));
+        const rarityOk = trait.maxRarity == null || RARITY_RANK[rarity] <= RARITY_RANK[trait.maxRarity];
+        return roleMatch && rarityOk;
     }).map(trait => trait.name);
     return shuffle(filteredTraits).slice(0, traitCount);
 }

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

@@ -90,5 +90,79 @@
             "OUTSIDE_HITTER",
             "MIDDLE_BLOCKER"
         ]
+    },
+    {
+        "name": "QUICK_LEARNER",
+        "chance": 1,
+        "roles": [
+            "SETTER",
+            "LIBERO",
+            "OUTSIDE_HITTER"
+        ]
+    },
+    {
+        "name": "MOMENTUM_ADDICT",
+        "chance": 1,
+        "roles": [
+            "OUTSIDE_HITTER",
+            "OPPOSITE_HITTER",
+            "MIDDLE_BLOCKER"
+        ]
+    },
+    {
+        "name": "LOUDMOUTH",
+        "chance": 0.25,
+        "roles": [
+            "OUTSIDE_HITTER",
+            "OPPOSITE_HITTER",
+            "MIDDLE_BLOCKER"
+        ]
+    },
+    {
+        "name": "TRUE_LEADER",
+        "chance": 0.3,
+        "roles": [
+            "SETTER",
+            "LIBERO",
+            "OUTSIDE_HITTER"
+        ]
+    },
+    {
+        "name": "OVERACHIEVER",
+        "chance": 0.2,
+        "maxRarity": "MYTHIC",
+        "roles": [
+            "LIBERO",
+            "OUTSIDE_HITTER",
+            "MIDDLE_BLOCKER"
+        ]
+    },
+    {
+        "name": "CRAFTY",
+        "chance": 0.3,
+        "roles": [
+            "SETTER",
+            "OUTSIDE_HITTER",
+            "OPPOSITE_HITTER",
+            "MIDDLE_BLOCKER"
+        ]
+    },
+    {
+        "name": "TENACIOUS",
+        "chance": 1,
+        "roles": [
+            "SETTER",
+            "LIBERO",
+            "OUTSIDE_HITTER"
+        ]
+    },
+    {
+        "name": "HUNTER",
+        "chance": 0.15,
+        "roles": [
+            "SETTER",
+            "OPPOSITE_HITTER",
+            "OUTSIDE_HITTER"
+        ]
     }
 ]

package/package.json CHANGED Viewed

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