volleyballsimtypes 0.0.526 → 0.0.527

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

@@ -196,7 +196,7 @@ export type Team = Omit<DataProps<_Team>, 'roster' | '_rating' | 'rating' | 'tac
     nationalManager?: {
         displayName: string;
         teamId: string;
-        teamShortName: string;
+        teamName: string;
     };
 };
 export type Standing = DataProps<_Standing> & {

package/dist/cjs/src/data/models/team-jersey.d.ts

@@ -1,10 +1,11 @@
 import * as Sequelize from 'sequelize';
 import { Model } from 'sequelize';
 import { TeamId, TeamModel } from '.';
-import { JerseyConfig } from '../../service';
+import { JerseyConfig, AlternateJerseyConfig } from '../../service';
 export interface TeamJerseyAttributes {
     team_id: string;
     config: JerseyConfig;
+    alternate_config?: AlternateJerseyConfig | null;
 }
 export type TeamJerseyPk = 'team_id';
 export type TeamJerseyId = TeamJerseyModel[TeamJerseyPk];
@@ -12,6 +13,7 @@ export type TeamJerseyCreationAttributes = TeamJerseyAttributes;
 export declare class TeamJerseyModel extends Model<TeamJerseyAttributes, TeamJerseyCreationAttributes> implements TeamJerseyAttributes {
     team_id: string;
     config: JerseyConfig;
+    alternate_config?: AlternateJerseyConfig | null;
     team: TeamModel;
     getTeam: Sequelize.BelongsToGetAssociationMixin<TeamModel>;
     setTeam: Sequelize.BelongsToSetAssociationMixin<TeamModel, TeamId>;

package/dist/cjs/src/data/models/team-jersey.js

@@ -17,6 +17,10 @@ class TeamJerseyModel extends sequelize_1.Model {
             config: {
                 type: sequelize_1.DataTypes.JSONB,
                 allowNull: false
+            },
+            alternate_config: {
+                type: sequelize_1.DataTypes.JSONB,
+                allowNull: true
             }
         }, {
             sequelize,

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

@@ -53,6 +53,7 @@ function transformToObject(model, currentIteration, tacticsOverride) {
         divisionId: model.division_id,
         // Present only when the caller explicitly included the TeamJersey association (editor / effective-jersey
         // resolver); undefined on ordinary team loads, which heals to the id-derived default in the UI.
-        jerseyConfig: model.TeamJersey?.config
+        jerseyConfig: model.TeamJersey?.config,
+        alternateJerseyConfig: model.TeamJersey?.alternate_config ?? undefined
     });
 }

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

@@ -1,5 +1,6 @@
 export * from './team';
 export * from './jersey';
+export * from './jersey-defaults';
 export * from './team-generator';
 export * from './formation';
 export * from './tactics';

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

@@ -16,6 +16,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./team"), exports);
 __exportStar(require("./jersey"), exports);
+__exportStar(require("./jersey-defaults"), exports);
 __exportStar(require("./team-generator"), exports);
 __exportStar(require("./formation"), exports);
 __exportStar(require("./tactics"), exports);

package/dist/cjs/src/service/team/jersey-defaults.d.ts

@@ -0,0 +1,13 @@
+import type { JerseyConfig, JerseyClothing, JerseyPattern, JerseyFont } from './jersey';
+export interface JerseyPalette {
+    color1: string;
+    color2: string;
+    color3: string;
+    number1: string;
+    number2: string;
+}
+export declare const JERSEY_PALETTES: readonly JerseyPalette[];
+export declare const JERSEY_PATTERN_ORDER: readonly JerseyPattern[];
+export declare const JERSEY_CLOTHING_ORDER: readonly JerseyClothing[];
+export declare const JERSEY_FONT_ORDER: readonly JerseyFont[];
+export declare function jerseyFromTeamId(teamId: string): JerseyConfig;

package/dist/cjs/src/service/team/jersey-defaults.js

@@ -0,0 +1,79 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.JERSEY_FONT_ORDER = exports.JERSEY_CLOTHING_ORDER = exports.JERSEY_PATTERN_ORDER = exports.JERSEY_PALETTES = void 0;
+exports.jerseyFromTeamId = jerseyFromTeamId;
+// FNV-1a hash of a string, used to seed the PRNG below from a team id.
+function hashSeed(str) {
+    let h = 2166136261;
+    for (let i = 0; i < str.length; i++) {
+        h ^= str.charCodeAt(i);
+        h = Math.imul(h, 16777619);
+    }
+    return h >>> 0;
+}
+// mulberry32: a tiny deterministic PRNG. Same seed -> same stream, so a team's kit is stable and reproducible.
+function mulberry32(seed) {
+    let a = seed;
+    return () => {
+        a = (a + 0x6d2b79f5) | 0;
+        let t = Math.imul(a ^ (a >>> 15), 1 | a);
+        t = (t + Math.imul(t ^ (t >>> 7), 61 | t)) ^ t;
+        return ((t ^ (t >>> 14)) >>> 0) / 4294967296;
+    };
+}
+exports.JERSEY_PALETTES = [
+    { color1: '#606c38', color2: '#dda15e', color3: '#bc6c25', number1: '#fefae0', number2: '#283618' },
+    { color1: '#780000', color2: '#669bbc', color3: '#c1121f', number1: '#fdf0d5', number2: '#003049' },
+    { color1: '#2a9d8f', color2: '#f4a261', color3: '#e76f51', number1: '#264653', number2: '#e9c46a' },
+    { color1: '#219ebc', color2: '#fb8500', color3: '#8ecae6', number1: '#023047', number2: '#ffb703' },
+    { color1: '#1d3557', color2: '#e63946', color3: '#a8dadc', number1: '#f1faee', number2: '#457b9d' },
+    { color1: '#003566', color2: '#ffc300', color3: '#001d3d', number1: '#ffd60a', number2: '#000814' },
+    { color1: '#bc4749', color2: '#6a994e', color3: '#a7c957', number1: '#f2e8cf', number2: '#386641' },
+    { color1: '#6f1d1b', color2: '#99582a', color3: '#bb9457', number1: '#ffe6a7', number2: '#432818' },
+    { color1: '#ef476f', color2: '#118ab2', color3: '#ffd166', number1: '#ffd166', number2: '#073b4c' },
+    { color1: '#16425b', color2: '#3a7ca5', color3: '#81c3d7', number1: '#d9dcd6', number2: '#2f6690' },
+    { color1: '#ee6c4d', color2: '#3d5a80', color3: '#98c1d9', number1: '#e0fbfc', number2: '#293241' },
+    { color1: '#e09f3e', color2: '#335c67', color3: '#9e2a2b', number1: '#fff3b0', number2: '#540b0e' },
+    { color1: '#9a031e', color2: '#fb8b24', color3: '#e36414', number1: '#0f4c5c', number2: '#5f0f40' },
+    { color1: '#127475', color2: '#f2542d', color3: '#0e9594', number1: '#f5dfbb', number2: '#562c2c' },
+    { color1: '#bc4b51', color2: '#8cb369', color3: '#f4a259', number1: '#f4e285', number2: '#5b8e7d' },
+    { color1: '#7678ed', color2: '#f18701', color3: '#f35b04', number1: '#f7b801', number2: '#3d348b' },
+    { color1: '#14213d', color2: '#fca311', color3: '#e5e5e5', number1: '#ffffff', number2: '#000000' },
+    { color1: '#e07a5f', color2: '#81b29a', color3: '#f2cc8f', number1: '#f4f1de', number2: '#3d405b' },
+    { color1: '#f79824', color2: '#33a1fd', color3: '#fdca40', number1: '#33a1fd', number2: '#31393c' },
+    { color1: '#619b8a', color2: '#fe7f2d', color3: '#a1c181', number1: '#fcca46', number2: '#233d4d' },
+    { color1: '#227c9d', color2: '#17c3b2', color3: '#ffcb77', number1: '#fef9ef', number2: '#fe6d73' },
+    { color1: '#19647e', color2: '#119da4', color3: '#1f2041', number1: '#4b3f72', number2: '#ffc857' }
+];
+exports.JERSEY_PATTERN_ORDER = [
+    'solid', 'verticalStripes', 'verticalBars', 'pinstripes', 'hoops', 'checkered', 'diagonalSash', 'splitHalves',
+    'chevron', 'shoulderYoke', 'sidePanels', 'centerBand', 'gradientFade', 'twoToneSplit'
+];
+exports.JERSEY_CLOTHING_ORDER = [
+    'shirtCrewNeck', 'shirtCrewNeckSleeveless', 'shirtVNeck', 'shirtVNeckSleeveless', 'collarAndSweater', 'collarAndSweaterSleeveless'
+];
+// Free-user fonts: the id-derived random for a team's default kit picks ONLY from these (premium fonts are vector
+// glyph paths that require the UI rendering pipeline).
+exports.JERSEY_FONT_ORDER = ['sans', 'wide', 'mono', 'serif', 'block'];
+// The full jersey a team wears by default: every category is drawn deterministically from the team id, so each team
+// gets its own stable, distinct kit. Colours come from ONE randomly-assigned JERSEY_PALETTE (harmonious by design);
+// clothing / pattern / font stay random per team.
+function jerseyFromTeamId(teamId) {
+    const rng = mulberry32(hashSeed(teamId));
+    const pickFrom = (arr) => arr[Math.floor(rng() * arr.length)];
+    const palette = pickFrom(exports.JERSEY_PALETTES);
+    return {
+        clothing: pickFrom(exports.JERSEY_CLOTHING_ORDER),
+        pattern: pickFrom(exports.JERSEY_PATTERN_ORDER),
+        colors: [palette.color1, palette.color2, palette.color3],
+        font: pickFrom(exports.JERSEY_FONT_ORDER),
+        numberColor: palette.number1,
+        numberOutline: palette.number2,
+        numberOutlineEnabled: true,
+        numberSpacing: 0,
+        numberSize: 46,
+        brand: 'none',
+        brandColor1: '#ffffff',
+        brandColor2: '#1e293b'
+    };
+}

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

@@ -72,3 +72,32 @@ export type JerseyConfig = z.infer<typeof JerseySchema>;
 export type JerseyClothing = JerseyConfig['clothing'];
 export type JerseyPattern = JerseyConfig['pattern'];
 export type JerseyFont = JerseyConfig['font'];
+export declare const AlternateJerseySchema: z.ZodObject<{
+    pattern: z.ZodEnum<{
+        solid: "solid";
+        verticalStripes: "verticalStripes";
+        verticalBars: "verticalBars";
+        pinstripes: "pinstripes";
+        hoops: "hoops";
+        checkered: "checkered";
+        diagonalSash: "diagonalSash";
+        splitHalves: "splitHalves";
+        chevron: "chevron";
+        shoulderYoke: "shoulderYoke";
+        sidePanels: "sidePanels";
+        centerBand: "centerBand";
+        gradientFade: "gradientFade";
+        twoToneSplit: "twoToneSplit";
+    }>;
+    colors: z.ZodArray<z.ZodString>;
+    numberColor: z.ZodString;
+    numberOutline: z.ZodString;
+    numberOutlineEnabled: z.ZodDefault<z.ZodBoolean>;
+    brandColor1: z.ZodDefault<z.ZodString>;
+    brandColor2: z.ZodDefault<z.ZodString>;
+}, z.core.$strip>;
+export type AlternateJerseyConfig = z.infer<typeof AlternateJerseySchema>;
+export declare function complementaryHex(hex: string): string;
+export declare function relativeLuminance(hex: string): number;
+export declare function computeComplementaryJersey(main: JerseyConfig): JerseyConfig;
+export declare function mergeAlternateJersey(main: JerseyConfig, alt: AlternateJerseyConfig): JerseyConfig;

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

@@ -1,6 +1,10 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.JerseySchema = void 0;
+exports.AlternateJerseySchema = exports.JerseySchema = void 0;
+exports.complementaryHex = complementaryHex;
+exports.relativeLuminance = relativeLuminance;
+exports.computeComplementaryJersey = computeComplementaryJersey;
+exports.mergeAlternateJersey = mergeAlternateJersey;
 const zod_1 = require("zod");
 // 6-digit hex (#rrggbb) or 8-digit hex with alpha (#rrggbbaa). The 8-digit form comes from the UI's opacity-enabled
 // colour pickers; SVG fills render both natively.
@@ -31,3 +35,123 @@ exports.JerseySchema = zod_1.z.object({
     brandColor1: hexColor.default('#ffffff'),
     brandColor2: hexColor.default('#1e293b')
 });
+// The alternate (libero) kit stores only the fields the premium editor allows changing. Locked fields (clothing,
+// font, brand icon, numberSpacing, numberSize) are always inherited from the main kit at render time.
+exports.AlternateJerseySchema = zod_1.z.object({
+    pattern: exports.JerseySchema.shape.pattern,
+    colors: exports.JerseySchema.shape.colors,
+    numberColor: hexColor,
+    numberOutline: hexColor,
+    numberOutlineEnabled: zod_1.z.boolean().default(true),
+    brandColor1: hexColor.default('#ffffff'),
+    brandColor2: hexColor.default('#1e293b')
+});
+// ---------------------------------------------------------------------------
+// Colour utilities (pure math, zero deps)
+// ---------------------------------------------------------------------------
+function hexToRgb(hex) {
+    const h = hex.replace('#', '').slice(0, 6);
+    return [parseInt(h.slice(0, 2), 16), parseInt(h.slice(2, 4), 16), parseInt(h.slice(4, 6), 16)];
+}
+function rgbToHex(r, g, b) {
+    return '#' + [r, g, b].map(v => Math.round(Math.max(0, Math.min(255, v))).toString(16).padStart(2, '0')).join('');
+}
+function rgbToHsl(r, g, b) {
+    r /= 255;
+    g /= 255;
+    b /= 255;
+    const max = Math.max(r, g, b);
+    const min = Math.min(r, g, b);
+    const l = (max + min) / 2;
+    if (max === min)
+        return [0, 0, l];
+    const d = max - min;
+    const s = l > 0.5 ? d / (2 - max - min) : d / (max + min);
+    let h = 0;
+    if (max === r)
+        h = ((g - b) / d + (g < b ? 6 : 0)) / 6;
+    else if (max === g)
+        h = ((b - r) / d + 2) / 6;
+    else
+        h = ((r - g) / d + 4) / 6;
+    return [h, s, l];
+}
+function hslToRgb(h, s, l) {
+    if (s === 0) {
+        const v = Math.round(l * 255);
+        return [v, v, v];
+    }
+    const hue2rgb = (p, q, t) => {
+        if (t < 0)
+            t += 1;
+        if (t > 1)
+            t -= 1;
+        if (t < 1 / 6)
+            return p + (q - p) * 6 * t;
+        if (t < 1 / 2)
+            return q;
+        if (t < 2 / 3)
+            return p + (q - p) * (2 / 3 - t) * 6;
+        return p;
+    };
+    const q = l < 0.5 ? l * (1 + s) : l + s - l * s;
+    const p = 2 * l - q;
+    return [Math.round(hue2rgb(p, q, h + 1 / 3) * 255), Math.round(hue2rgb(p, q, h) * 255), Math.round(hue2rgb(p, q, h - 1 / 3) * 255)];
+}
+// Rotate a hex colour's hue by 180 degrees (complementary).
+function complementaryHex(hex) {
+    const [r, g, b] = hexToRgb(hex);
+    const [h, s, l] = rgbToHsl(r, g, b);
+    const [cr, cg, cb] = hslToRgb((h + 0.5) % 1, s, l);
+    return rgbToHex(cr, cg, cb);
+}
+// Relative luminance (WCAG 2.x formula, 0 = black, 1 = white).
+function relativeLuminance(hex) {
+    const [r, g, b] = hexToRgb(hex);
+    const srgb = [r, g, b].map(v => {
+        v /= 255;
+        return v <= 0.03928 ? v / 12.92 : Math.pow((v + 0.055) / 1.055, 2.4);
+    });
+    return 0.2126 * srgb[0] + 0.7152 * srgb[1] + 0.0722 * srgb[2];
+}
+// Build the libero alternate kit from the main kit using complementary colours. Every colour in the
+// pattern and the brand is hue-rotated 180 degrees; the chest-number fill/outline are picked for
+// readability against the new primary colour (dark number on light, light number on dark).
+function computeComplementaryJersey(main) {
+    const compColors = main.colors.map(c => complementaryHex(c));
+    const lum = relativeLuminance(compColors[0]);
+    return {
+        // Locked fields: inherited from main
+        clothing: main.clothing,
+        font: main.font,
+        brand: main.brand,
+        numberSpacing: main.numberSpacing,
+        numberSize: main.numberSize,
+        // Editable fields: complementary-derived
+        pattern: main.pattern,
+        colors: compColors,
+        numberColor: lum > 0.4 ? '#1a1a1a' : '#ffffff',
+        numberOutline: lum > 0.4 ? '#ffffff' : '#1a1a1a',
+        numberOutlineEnabled: main.numberOutlineEnabled,
+        brandColor1: complementaryHex(main.brandColor1),
+        brandColor2: complementaryHex(main.brandColor2)
+    };
+}
+// Merge a stored alternate (partial, editable fields only) with the main kit's locked fields to
+// produce a full JerseyConfig for rendering.
+function mergeAlternateJersey(main, alt) {
+    return {
+        clothing: main.clothing,
+        font: main.font,
+        brand: main.brand,
+        numberSpacing: main.numberSpacing,
+        numberSize: main.numberSize,
+        pattern: alt.pattern,
+        colors: alt.colors,
+        numberColor: alt.numberColor,
+        numberOutline: alt.numberOutline,
+        numberOutlineEnabled: alt.numberOutlineEnabled,
+        brandColor1: alt.brandColor1,
+        brandColor2: alt.brandColor2
+    };
+}

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

@@ -414,5 +414,29 @@ export declare const TeamInputSchema: z.ZodObject<{
         brandColor1: z.ZodDefault<z.ZodString>;
         brandColor2: z.ZodDefault<z.ZodString>;
     }, z.core.$strip>>;
+    alternateJerseyConfig: z.ZodOptional<z.ZodObject<{
+        pattern: z.ZodEnum<{
+            solid: "solid";
+            verticalStripes: "verticalStripes";
+            verticalBars: "verticalBars";
+            pinstripes: "pinstripes";
+            hoops: "hoops";
+            checkered: "checkered";
+            diagonalSash: "diagonalSash";
+            splitHalves: "splitHalves";
+            chevron: "chevron";
+            shoulderYoke: "shoulderYoke";
+            sidePanels: "sidePanels";
+            centerBand: "centerBand";
+            gradientFade: "gradientFade";
+            twoToneSplit: "twoToneSplit";
+        }>;
+        colors: z.ZodArray<z.ZodString>;
+        numberColor: z.ZodString;
+        numberOutline: z.ZodString;
+        numberOutlineEnabled: z.ZodDefault<z.ZodBoolean>;
+        brandColor1: z.ZodDefault<z.ZodString>;
+        brandColor2: z.ZodDefault<z.ZodString>;
+    }, z.core.$strip>>;
 }, z.core.$strip>;
 export type TeamInput = z.infer<typeof TeamInputSchema>;

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

@@ -22,7 +22,8 @@ exports.TeamInputSchema = zod_1.z.object({
     country: countrySchema,
     legacyFlagCountry: countrySchema.optional(),
     tactics: tactics_z_1.TacticsInputSchema.optional(),
-    jerseyConfig: jersey_1.JerseySchema.optional()
+    jerseyConfig: jersey_1.JerseySchema.optional(),
+    alternateJerseyConfig: jersey_1.AlternateJerseySchema.optional()
 }).superRefine((data, ctx) => {
     const ids = data.roster.map(p => p.id);
     if (new Set(ids).size !== ids.length) {

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

@@ -1,7 +1,7 @@
 import { Player } from '../player';
 import { Country } from '../country';
 import { Tactics } from './tactics';
-import type { JerseyConfig } from './jersey';
+import type { JerseyConfig, AlternateJerseyConfig } from './jersey';
 export declare class Team {
     readonly id: string;
     readonly roster: Player[];
@@ -12,6 +12,7 @@ export declare class Team {
     readonly country: Country;
     readonly legacyFlagCountry?: Country;
     readonly jerseyConfig?: JerseyConfig;
+    readonly alternateJerseyConfig?: AlternateJerseyConfig;
     private _rating;
     static create(input: unknown): Team;
     private constructor();

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

@@ -19,7 +19,7 @@ class Team {
             tactics: result.data.tactics != null ? tactics_1.Tactics.create(result.data.tactics) : undefined
         });
     }
-    constructor({ id, rating, name, shortName, divisionId, country, legacyFlagCountry, roster, tactics, jerseyConfig }) {
+    constructor({ id, rating, name, shortName, divisionId, country, legacyFlagCountry, roster, tactics, jerseyConfig, alternateJerseyConfig }) {
         this.id = id;
         this._rating = rating;
         this.roster = roster;
@@ -30,6 +30,7 @@ class Team {
         this.country = country;
         this.legacyFlagCountry = legacyFlagCountry;
         this.jerseyConfig = jerseyConfig;
+        this.alternateJerseyConfig = alternateJerseyConfig;
     }
     get rating() {
         return this._rating;

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

@@ -196,7 +196,7 @@ export type Team = Omit<DataProps<_Team>, 'roster' | '_rating' | 'rating' | 'tac
     nationalManager?: {
         displayName: string;
         teamId: string;
-        teamShortName: string;
+        teamName: string;
     };
 };
 export type Standing = DataProps<_Standing> & {

package/dist/esm/src/data/models/team-jersey.d.ts

@@ -1,10 +1,11 @@
 import * as Sequelize from 'sequelize';
 import { Model } from 'sequelize';
 import { TeamId, TeamModel } from '.';
-import { JerseyConfig } from '../../service';
+import { JerseyConfig, AlternateJerseyConfig } from '../../service';
 export interface TeamJerseyAttributes {
     team_id: string;
     config: JerseyConfig;
+    alternate_config?: AlternateJerseyConfig | null;
 }
 export type TeamJerseyPk = 'team_id';
 export type TeamJerseyId = TeamJerseyModel[TeamJerseyPk];
@@ -12,6 +13,7 @@ export type TeamJerseyCreationAttributes = TeamJerseyAttributes;
 export declare class TeamJerseyModel extends Model<TeamJerseyAttributes, TeamJerseyCreationAttributes> implements TeamJerseyAttributes {
     team_id: string;
     config: JerseyConfig;
+    alternate_config?: AlternateJerseyConfig | null;
     team: TeamModel;
     getTeam: Sequelize.BelongsToGetAssociationMixin<TeamModel>;
     setTeam: Sequelize.BelongsToSetAssociationMixin<TeamModel, TeamId>;

package/dist/esm/src/data/models/team-jersey.js

@@ -14,6 +14,10 @@ export class TeamJerseyModel extends Model {
             config: {
                 type: DataTypes.JSONB,
                 allowNull: false
+            },
+            alternate_config: {
+                type: DataTypes.JSONB,
+                allowNull: true
             }
         }, {
             sequelize,

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

@@ -46,7 +46,8 @@ function transformToObject(model, currentIteration, tacticsOverride) {
         divisionId: model.division_id,
         // Present only when the caller explicitly included the TeamJersey association (editor / effective-jersey
         // resolver); undefined on ordinary team loads, which heals to the id-derived default in the UI.
-        jerseyConfig: model.TeamJersey?.config
+        jerseyConfig: model.TeamJersey?.config,
+        alternateJerseyConfig: model.TeamJersey?.alternate_config ?? undefined
     });
 }
 export { transformToObject as transformToTeam, transformToAttributes as transformFromTeam };

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

@@ -1,5 +1,6 @@
 export * from './team';
 export * from './jersey';
+export * from './jersey-defaults';
 export * from './team-generator';
 export * from './formation';
 export * from './tactics';

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

@@ -1,5 +1,6 @@
 export * from './team';
 export * from './jersey';
+export * from './jersey-defaults';
 export * from './team-generator';
 export * from './formation';
 export * from './tactics';

package/dist/esm/src/service/team/jersey-defaults.d.ts

@@ -0,0 +1,13 @@
+import type { JerseyConfig, JerseyClothing, JerseyPattern, JerseyFont } from './jersey';
+export interface JerseyPalette {
+    color1: string;
+    color2: string;
+    color3: string;
+    number1: string;
+    number2: string;
+}
+export declare const JERSEY_PALETTES: readonly JerseyPalette[];
+export declare const JERSEY_PATTERN_ORDER: readonly JerseyPattern[];
+export declare const JERSEY_CLOTHING_ORDER: readonly JerseyClothing[];
+export declare const JERSEY_FONT_ORDER: readonly JerseyFont[];
+export declare function jerseyFromTeamId(teamId: string): JerseyConfig;

package/dist/esm/src/service/team/jersey-defaults.js

@@ -0,0 +1,75 @@
+// FNV-1a hash of a string, used to seed the PRNG below from a team id.
+function hashSeed(str) {
+    let h = 2166136261;
+    for (let i = 0; i < str.length; i++) {
+        h ^= str.charCodeAt(i);
+        h = Math.imul(h, 16777619);
+    }
+    return h >>> 0;
+}
+// mulberry32: a tiny deterministic PRNG. Same seed -> same stream, so a team's kit is stable and reproducible.
+function mulberry32(seed) {
+    let a = seed;
+    return () => {
+        a = (a + 0x6d2b79f5) | 0;
+        let t = Math.imul(a ^ (a >>> 15), 1 | a);
+        t = (t + Math.imul(t ^ (t >>> 7), 61 | t)) ^ t;
+        return ((t ^ (t >>> 14)) >>> 0) / 4294967296;
+    };
+}
+export const JERSEY_PALETTES = [
+    { color1: '#606c38', color2: '#dda15e', color3: '#bc6c25', number1: '#fefae0', number2: '#283618' },
+    { color1: '#780000', color2: '#669bbc', color3: '#c1121f', number1: '#fdf0d5', number2: '#003049' },
+    { color1: '#2a9d8f', color2: '#f4a261', color3: '#e76f51', number1: '#264653', number2: '#e9c46a' },
+    { color1: '#219ebc', color2: '#fb8500', color3: '#8ecae6', number1: '#023047', number2: '#ffb703' },
+    { color1: '#1d3557', color2: '#e63946', color3: '#a8dadc', number1: '#f1faee', number2: '#457b9d' },
+    { color1: '#003566', color2: '#ffc300', color3: '#001d3d', number1: '#ffd60a', number2: '#000814' },
+    { color1: '#bc4749', color2: '#6a994e', color3: '#a7c957', number1: '#f2e8cf', number2: '#386641' },
+    { color1: '#6f1d1b', color2: '#99582a', color3: '#bb9457', number1: '#ffe6a7', number2: '#432818' },
+    { color1: '#ef476f', color2: '#118ab2', color3: '#ffd166', number1: '#ffd166', number2: '#073b4c' },
+    { color1: '#16425b', color2: '#3a7ca5', color3: '#81c3d7', number1: '#d9dcd6', number2: '#2f6690' },
+    { color1: '#ee6c4d', color2: '#3d5a80', color3: '#98c1d9', number1: '#e0fbfc', number2: '#293241' },
+    { color1: '#e09f3e', color2: '#335c67', color3: '#9e2a2b', number1: '#fff3b0', number2: '#540b0e' },
+    { color1: '#9a031e', color2: '#fb8b24', color3: '#e36414', number1: '#0f4c5c', number2: '#5f0f40' },
+    { color1: '#127475', color2: '#f2542d', color3: '#0e9594', number1: '#f5dfbb', number2: '#562c2c' },
+    { color1: '#bc4b51', color2: '#8cb369', color3: '#f4a259', number1: '#f4e285', number2: '#5b8e7d' },
+    { color1: '#7678ed', color2: '#f18701', color3: '#f35b04', number1: '#f7b801', number2: '#3d348b' },
+    { color1: '#14213d', color2: '#fca311', color3: '#e5e5e5', number1: '#ffffff', number2: '#000000' },
+    { color1: '#e07a5f', color2: '#81b29a', color3: '#f2cc8f', number1: '#f4f1de', number2: '#3d405b' },
+    { color1: '#f79824', color2: '#33a1fd', color3: '#fdca40', number1: '#33a1fd', number2: '#31393c' },
+    { color1: '#619b8a', color2: '#fe7f2d', color3: '#a1c181', number1: '#fcca46', number2: '#233d4d' },
+    { color1: '#227c9d', color2: '#17c3b2', color3: '#ffcb77', number1: '#fef9ef', number2: '#fe6d73' },
+    { color1: '#19647e', color2: '#119da4', color3: '#1f2041', number1: '#4b3f72', number2: '#ffc857' }
+];
+export const JERSEY_PATTERN_ORDER = [
+    'solid', 'verticalStripes', 'verticalBars', 'pinstripes', 'hoops', 'checkered', 'diagonalSash', 'splitHalves',
+    'chevron', 'shoulderYoke', 'sidePanels', 'centerBand', 'gradientFade', 'twoToneSplit'
+];
+export const JERSEY_CLOTHING_ORDER = [
+    'shirtCrewNeck', 'shirtCrewNeckSleeveless', 'shirtVNeck', 'shirtVNeckSleeveless', 'collarAndSweater', 'collarAndSweaterSleeveless'
+];
+// Free-user fonts: the id-derived random for a team's default kit picks ONLY from these (premium fonts are vector
+// glyph paths that require the UI rendering pipeline).
+export const JERSEY_FONT_ORDER = ['sans', 'wide', 'mono', 'serif', 'block'];
+// The full jersey a team wears by default: every category is drawn deterministically from the team id, so each team
+// gets its own stable, distinct kit. Colours come from ONE randomly-assigned JERSEY_PALETTE (harmonious by design);
+// clothing / pattern / font stay random per team.
+export function jerseyFromTeamId(teamId) {
+    const rng = mulberry32(hashSeed(teamId));
+    const pickFrom = (arr) => arr[Math.floor(rng() * arr.length)];
+    const palette = pickFrom(JERSEY_PALETTES);
+    return {
+        clothing: pickFrom(JERSEY_CLOTHING_ORDER),
+        pattern: pickFrom(JERSEY_PATTERN_ORDER),
+        colors: [palette.color1, palette.color2, palette.color3],
+        font: pickFrom(JERSEY_FONT_ORDER),
+        numberColor: palette.number1,
+        numberOutline: palette.number2,
+        numberOutlineEnabled: true,
+        numberSpacing: 0,
+        numberSize: 46,
+        brand: 'none',
+        brandColor1: '#ffffff',
+        brandColor2: '#1e293b'
+    };
+}

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

@@ -72,3 +72,32 @@ export type JerseyConfig = z.infer<typeof JerseySchema>;
 export type JerseyClothing = JerseyConfig['clothing'];
 export type JerseyPattern = JerseyConfig['pattern'];
 export type JerseyFont = JerseyConfig['font'];
+export declare const AlternateJerseySchema: z.ZodObject<{
+    pattern: z.ZodEnum<{
+        solid: "solid";
+        verticalStripes: "verticalStripes";
+        verticalBars: "verticalBars";
+        pinstripes: "pinstripes";
+        hoops: "hoops";
+        checkered: "checkered";
+        diagonalSash: "diagonalSash";
+        splitHalves: "splitHalves";
+        chevron: "chevron";
+        shoulderYoke: "shoulderYoke";
+        sidePanels: "sidePanels";
+        centerBand: "centerBand";
+        gradientFade: "gradientFade";
+        twoToneSplit: "twoToneSplit";
+    }>;
+    colors: z.ZodArray<z.ZodString>;
+    numberColor: z.ZodString;
+    numberOutline: z.ZodString;
+    numberOutlineEnabled: z.ZodDefault<z.ZodBoolean>;
+    brandColor1: z.ZodDefault<z.ZodString>;
+    brandColor2: z.ZodDefault<z.ZodString>;
+}, z.core.$strip>;
+export type AlternateJerseyConfig = z.infer<typeof AlternateJerseySchema>;
+export declare function complementaryHex(hex: string): string;
+export declare function relativeLuminance(hex: string): number;
+export declare function computeComplementaryJersey(main: JerseyConfig): JerseyConfig;
+export declare function mergeAlternateJersey(main: JerseyConfig, alt: AlternateJerseyConfig): JerseyConfig;

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

@@ -28,3 +28,123 @@ export const JerseySchema = z.object({
     brandColor1: hexColor.default('#ffffff'),
     brandColor2: hexColor.default('#1e293b')
 });
+// The alternate (libero) kit stores only the fields the premium editor allows changing. Locked fields (clothing,
+// font, brand icon, numberSpacing, numberSize) are always inherited from the main kit at render time.
+export const AlternateJerseySchema = z.object({
+    pattern: JerseySchema.shape.pattern,
+    colors: JerseySchema.shape.colors,
+    numberColor: hexColor,
+    numberOutline: hexColor,
+    numberOutlineEnabled: z.boolean().default(true),
+    brandColor1: hexColor.default('#ffffff'),
+    brandColor2: hexColor.default('#1e293b')
+});
+// ---------------------------------------------------------------------------
+// Colour utilities (pure math, zero deps)
+// ---------------------------------------------------------------------------
+function hexToRgb(hex) {
+    const h = hex.replace('#', '').slice(0, 6);
+    return [parseInt(h.slice(0, 2), 16), parseInt(h.slice(2, 4), 16), parseInt(h.slice(4, 6), 16)];
+}
+function rgbToHex(r, g, b) {
+    return '#' + [r, g, b].map(v => Math.round(Math.max(0, Math.min(255, v))).toString(16).padStart(2, '0')).join('');
+}
+function rgbToHsl(r, g, b) {
+    r /= 255;
+    g /= 255;
+    b /= 255;
+    const max = Math.max(r, g, b);
+    const min = Math.min(r, g, b);
+    const l = (max + min) / 2;
+    if (max === min)
+        return [0, 0, l];
+    const d = max - min;
+    const s = l > 0.5 ? d / (2 - max - min) : d / (max + min);
+    let h = 0;
+    if (max === r)
+        h = ((g - b) / d + (g < b ? 6 : 0)) / 6;
+    else if (max === g)
+        h = ((b - r) / d + 2) / 6;
+    else
+        h = ((r - g) / d + 4) / 6;
+    return [h, s, l];
+}
+function hslToRgb(h, s, l) {
+    if (s === 0) {
+        const v = Math.round(l * 255);
+        return [v, v, v];
+    }
+    const hue2rgb = (p, q, t) => {
+        if (t < 0)
+            t += 1;
+        if (t > 1)
+            t -= 1;
+        if (t < 1 / 6)
+            return p + (q - p) * 6 * t;
+        if (t < 1 / 2)
+            return q;
+        if (t < 2 / 3)
+            return p + (q - p) * (2 / 3 - t) * 6;
+        return p;
+    };
+    const q = l < 0.5 ? l * (1 + s) : l + s - l * s;
+    const p = 2 * l - q;
+    return [Math.round(hue2rgb(p, q, h + 1 / 3) * 255), Math.round(hue2rgb(p, q, h) * 255), Math.round(hue2rgb(p, q, h - 1 / 3) * 255)];
+}
+// Rotate a hex colour's hue by 180 degrees (complementary).
+export function complementaryHex(hex) {
+    const [r, g, b] = hexToRgb(hex);
+    const [h, s, l] = rgbToHsl(r, g, b);
+    const [cr, cg, cb] = hslToRgb((h + 0.5) % 1, s, l);
+    return rgbToHex(cr, cg, cb);
+}
+// Relative luminance (WCAG 2.x formula, 0 = black, 1 = white).
+export function relativeLuminance(hex) {
+    const [r, g, b] = hexToRgb(hex);
+    const srgb = [r, g, b].map(v => {
+        v /= 255;
+        return v <= 0.03928 ? v / 12.92 : Math.pow((v + 0.055) / 1.055, 2.4);
+    });
+    return 0.2126 * srgb[0] + 0.7152 * srgb[1] + 0.0722 * srgb[2];
+}
+// Build the libero alternate kit from the main kit using complementary colours. Every colour in the
+// pattern and the brand is hue-rotated 180 degrees; the chest-number fill/outline are picked for
+// readability against the new primary colour (dark number on light, light number on dark).
+export function computeComplementaryJersey(main) {
+    const compColors = main.colors.map(c => complementaryHex(c));
+    const lum = relativeLuminance(compColors[0]);
+    return {
+        // Locked fields: inherited from main
+        clothing: main.clothing,
+        font: main.font,
+        brand: main.brand,
+        numberSpacing: main.numberSpacing,
+        numberSize: main.numberSize,
+        // Editable fields: complementary-derived
+        pattern: main.pattern,
+        colors: compColors,
+        numberColor: lum > 0.4 ? '#1a1a1a' : '#ffffff',
+        numberOutline: lum > 0.4 ? '#ffffff' : '#1a1a1a',
+        numberOutlineEnabled: main.numberOutlineEnabled,
+        brandColor1: complementaryHex(main.brandColor1),
+        brandColor2: complementaryHex(main.brandColor2)
+    };
+}
+// Merge a stored alternate (partial, editable fields only) with the main kit's locked fields to
+// produce a full JerseyConfig for rendering.
+export function mergeAlternateJersey(main, alt) {
+    return {
+        clothing: main.clothing,
+        font: main.font,
+        brand: main.brand,
+        numberSpacing: main.numberSpacing,
+        numberSize: main.numberSize,
+        pattern: alt.pattern,
+        colors: alt.colors,
+        numberColor: alt.numberColor,
+        numberOutline: alt.numberOutline,
+        numberOutlineEnabled: alt.numberOutlineEnabled,
+        brandColor1: alt.brandColor1,
+        brandColor2: alt.brandColor2
+    };
+}

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

@@ -414,5 +414,29 @@ export declare const TeamInputSchema: z.ZodObject<{
         brandColor1: z.ZodDefault<z.ZodString>;
         brandColor2: z.ZodDefault<z.ZodString>;
     }, z.core.$strip>>;
+    alternateJerseyConfig: z.ZodOptional<z.ZodObject<{
+        pattern: z.ZodEnum<{
+            solid: "solid";
+            verticalStripes: "verticalStripes";
+            verticalBars: "verticalBars";
+            pinstripes: "pinstripes";
+            hoops: "hoops";
+            checkered: "checkered";
+            diagonalSash: "diagonalSash";
+            splitHalves: "splitHalves";
+            chevron: "chevron";
+            shoulderYoke: "shoulderYoke";
+            sidePanels: "sidePanels";
+            centerBand: "centerBand";
+            gradientFade: "gradientFade";
+            twoToneSplit: "twoToneSplit";
+        }>;
+        colors: z.ZodArray<z.ZodString>;
+        numberColor: z.ZodString;
+        numberOutline: z.ZodString;
+        numberOutlineEnabled: z.ZodDefault<z.ZodBoolean>;
+        brandColor1: z.ZodDefault<z.ZodString>;
+        brandColor2: z.ZodDefault<z.ZodString>;
+    }, z.core.$strip>>;
 }, z.core.$strip>;
 export type TeamInput = z.infer<typeof TeamInputSchema>;

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

@@ -2,7 +2,7 @@ import { z } from 'zod';
 import { Player } from '../../player';
 import { Country } from '../../country';
 import { TacticsInputSchema } from './tactics.z';
-import { JerseySchema } from '../jersey';
+import { JerseySchema, AlternateJerseySchema } from '../jersey';
 const playerInstanceSchema = z.custom((v) => v instanceof Player, {
     message: 'INVALID_PLAYER_INSTANCE'
 });
@@ -19,7 +19,8 @@ export const TeamInputSchema = z.object({
     country: countrySchema,
     legacyFlagCountry: countrySchema.optional(),
     tactics: TacticsInputSchema.optional(),
-    jerseyConfig: JerseySchema.optional()
+    jerseyConfig: JerseySchema.optional(),
+    alternateJerseyConfig: AlternateJerseySchema.optional()
 }).superRefine((data, ctx) => {
     const ids = data.roster.map(p => p.id);
     if (new Set(ids).size !== ids.length) {

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

@@ -1,7 +1,7 @@
 import { Player } from '../player';
 import { Country } from '../country';
 import { Tactics } from './tactics';
-import type { JerseyConfig } from './jersey';
+import type { JerseyConfig, AlternateJerseyConfig } from './jersey';
 export declare class Team {
     readonly id: string;
     readonly roster: Player[];
@@ -12,6 +12,7 @@ export declare class Team {
     readonly country: Country;
     readonly legacyFlagCountry?: Country;
     readonly jerseyConfig?: JerseyConfig;
+    readonly alternateJerseyConfig?: AlternateJerseyConfig;
     private _rating;
     static create(input: unknown): Team;
     private constructor();

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

@@ -16,7 +16,7 @@ export class Team {
             tactics: result.data.tactics != null ? Tactics.create(result.data.tactics) : undefined
         });
     }
-    constructor({ id, rating, name, shortName, divisionId, country, legacyFlagCountry, roster, tactics, jerseyConfig }) {
+    constructor({ id, rating, name, shortName, divisionId, country, legacyFlagCountry, roster, tactics, jerseyConfig, alternateJerseyConfig }) {
         this.id = id;
         this._rating = rating;
         this.roster = roster;
@@ -27,6 +27,7 @@ export class Team {
         this.country = country;
         this.legacyFlagCountry = legacyFlagCountry;
         this.jerseyConfig = jerseyConfig;
+        this.alternateJerseyConfig = alternateJerseyConfig;
     }
     get rating() {
         return this._rating;

package/package.json

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