volleyballsimtypes 0.0.526 → 0.0.528

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

@@ -1,4 +1,4 @@
-import { BaseConfig, BoxScore, DataProps, DeclineStatus, JerseyConfig, Division as _Division, League as _League, Match as _Match, MatchSet as _MatchSet, Player as _Player, PlayerPosition, Qualifier as _Qualifier, QualifierMatch as _QualifierMatch, Rally as _Rally, RallyEvent as _RallyEvent, PointBreakdown, RallyMetrics, Season as _Season, Standing as _Standing, Team as _Team, Tournament as _Tournament, TournamentMatch as _TournamentMatch, National as _National, NationalMatch as _NationalMatch, Country as _Country, DefenceFormation, LineupFunction, CourtPosition, ConditionLogic, EnergyBand, MatchForfeitType, PerformanceStats, PinchCondition, RotationSystemEnum, SubBackMode, SubBand } from '../service';
+import { BadgeConfig, BaseConfig, BoxScore, DataProps, DeclineStatus, JerseyConfig, Division as _Division, League as _League, Match as _Match, MatchSet as _MatchSet, Player as _Player, PlayerPosition, Qualifier as _Qualifier, QualifierMatch as _QualifierMatch, Rally as _Rally, RallyEvent as _RallyEvent, PointBreakdown, RallyMetrics, Season as _Season, Standing as _Standing, Team as _Team, Tournament as _Tournament, TournamentMatch as _TournamentMatch, National as _National, NationalMatch as _NationalMatch, Country as _Country, DefenceFormation, LineupFunction, CourtPosition, ConditionLogic, EnergyBand, MatchForfeitType, PerformanceStats, PinchCondition, RotationSystemEnum, SubBackMode, SubBand } from '../service';
 export * from './tactics-player-refs';
 export type Rally = DataProps<_Rally> & {
     homePlayerPosition: PlayerPosition[];
@@ -85,6 +85,7 @@ export type Player = Omit<DataProps<_Player>, 'stats' | 'birthAge' | 'birthItera
     nickname?: string;
     jerseyConfig?: JerseyConfig;
     championBadge?: ChampionBadgeSpec;
+    teamBadge?: BadgeConfig;
     nationalFlagAlpha2?: string;
 };
 export interface StartingLineup {
@@ -196,8 +197,9 @@ export type Team = Omit<DataProps<_Team>, 'roster' | '_rating' | 'rating' | 'tac
     nationalManager?: {
         displayName: string;
         teamId: string;
-        teamShortName: string;
+        teamName: string;
     };
+    teamBadge?: BadgeConfig;
 };
 export type Standing = DataProps<_Standing> & {
     position: number;

package/dist/cjs/src/data/init-models.js

@@ -10,6 +10,7 @@ function initModels(sequelize) {
     const CurrencyTransaction = models_1.CurrencyTransactionModel.initModel(sequelize);
     const Tactics = models_1.TacticsModel.initModel(sequelize);
     const TeamJersey = models_1.TeamJerseyModel.initModel(sequelize);
+    const TeamBadge = models_1.TeamBadgeModel.initModel(sequelize);
     const LineupPreset = models_1.LineupPresetModel.initModel(sequelize);
     const MatchPreset = models_1.MatchPresetModel.initModel(sequelize);
     const Event = models_1.EventModel.initModel(sequelize);
@@ -255,6 +256,10 @@ function initModels(sequelize) {
     // and the effective-jersey resolver include it, so the simulator's team loads are unchanged.
     Team.hasOne(TeamJersey, { as: 'TeamJersey', foreignKey: 'team_id' });
     TeamJersey.belongsTo(Team, { as: 'team', foreignKey: 'team_id' });
+    // Saved premium badge. Same rule as TeamJersey: NOT in Team.defaultScope, included explicitly only by the
+    // management API (badge editor load), so the simulator's team loads are unchanged.
+    Team.hasOne(TeamBadge, { as: 'TeamBadge', foreignKey: 'team_id' });
+    TeamBadge.belongsTo(Team, { as: 'team', foreignKey: 'team_id' });
     // Lineup presets are loaded only by the management API; deliberately NOT in Team.defaultScope so the
     // simulator's team loads are unchanged (it reads the active config from the mirrored Tactics row).
     Team.hasMany(LineupPreset, { as: 'lineupPresets', foreignKey: 'team_id' });

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

@@ -45,6 +45,7 @@ export * from './team';
 export * from './team-replacement';
 export * from './tactics';
 export * from './team-jersey';
+export * from './team-badge';
 export * from './lineup-preset';
 export * from './base-position-preset';
 export * from './premium-grant';

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

@@ -61,6 +61,7 @@ __exportStar(require("./team"), exports);
 __exportStar(require("./team-replacement"), exports);
 __exportStar(require("./tactics"), exports);
 __exportStar(require("./team-jersey"), exports);
+__exportStar(require("./team-badge"), exports);
 __exportStar(require("./lineup-preset"), exports);
 __exportStar(require("./base-position-preset"), exports);
 __exportStar(require("./premium-grant"), exports);

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

@@ -0,0 +1,20 @@
+import * as Sequelize from 'sequelize';
+import { Model } from 'sequelize';
+import { TeamId, TeamModel } from '.';
+import { BadgeConfig } from '../../service';
+export interface TeamBadgeAttributes {
+    team_id: string;
+    config: BadgeConfig;
+}
+export type TeamBadgePk = 'team_id';
+export type TeamBadgeId = TeamBadgeModel[TeamBadgePk];
+export type TeamBadgeCreationAttributes = TeamBadgeAttributes;
+export declare class TeamBadgeModel extends Model<TeamBadgeAttributes, TeamBadgeCreationAttributes> implements TeamBadgeAttributes {
+    team_id: string;
+    config: BadgeConfig;
+    team: TeamModel;
+    getTeam: Sequelize.BelongsToGetAssociationMixin<TeamModel>;
+    setTeam: Sequelize.BelongsToSetAssociationMixin<TeamModel, TeamId>;
+    createTeam: Sequelize.BelongsToCreateAssociationMixin<TeamModel>;
+    static initModel(sequelize: Sequelize.Sequelize): typeof TeamBadgeModel;
+}

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

@@ -0,0 +1,38 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TeamBadgeModel = void 0;
+const sequelize_1 = require("sequelize");
+class TeamBadgeModel extends sequelize_1.Model {
+    static initModel(sequelize) {
+        return TeamBadgeModel.init({
+            team_id: {
+                type: sequelize_1.DataTypes.UUID,
+                allowNull: false,
+                primaryKey: true,
+                references: {
+                    model: 'Team',
+                    key: 'team_id'
+                }
+            },
+            config: {
+                type: sequelize_1.DataTypes.JSONB,
+                allowNull: false
+            }
+        }, {
+            sequelize,
+            tableName: 'TeamBadge',
+            schema: 'public',
+            timestamps: false,
+            indexes: [
+                {
+                    name: 'TeamBadge_pk',
+                    unique: true,
+                    fields: [
+                        { name: 'team_id' }
+                    ]
+                }
+            ]
+        });
+    }
+}
+exports.TeamBadgeModel = TeamBadgeModel;

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/models/team.d.ts

@@ -1,6 +1,6 @@
 import * as Sequelize from 'sequelize';
 import { Model, Optional } from 'sequelize';
-import { CompetitionChampionId, CompetitionChampionModel, CompetitionId, CompetitionModel, CompetitionTeamsId, CompetitionTeamsModel, CountryId, CountryModel, DivisionAttributes, DivisionId, DivisionModel, LegacyTeamFlagModel, MatchId, MatchModel, MatchRatingId, MatchRatingModel, PlayerAttributes, PlayerId, PlayerModel, PlayerTeamId, PlayerTeamModel, RallyId, RallyModel, TacticsAttributes, TacticsId, TacticsModel, TeamJerseyModel } from '.';
+import { CompetitionChampionId, CompetitionChampionModel, CompetitionId, CompetitionModel, CompetitionTeamsId, CompetitionTeamsModel, CountryId, CountryModel, DivisionAttributes, DivisionId, DivisionModel, LegacyTeamFlagModel, MatchId, MatchModel, MatchRatingId, MatchRatingModel, PlayerAttributes, PlayerId, PlayerModel, PlayerTeamId, PlayerTeamModel, RallyId, RallyModel, TacticsAttributes, TacticsId, TacticsModel, TeamJerseyModel, TeamBadgeModel } from '.';
 export interface TeamAttributes {
     team_id: string;
     name: string;
@@ -31,6 +31,8 @@ export declare class TeamModel extends Model<TeamAttributes, TeamCreationAttribu
     createTactics: Sequelize.HasOneCreateAssociationMixin<TacticsModel>;
     TeamJersey?: TeamJerseyModel;
     getTeamJersey: Sequelize.HasOneGetAssociationMixin<TeamJerseyModel>;
+    TeamBadge?: TeamBadgeModel;
+    getTeamBadge: Sequelize.HasOneGetAssociationMixin<TeamBadgeModel>;
     country: CountryModel;
     getCountry: Sequelize.BelongsToGetAssociationMixin<CountryModel>;
     setCountry: Sequelize.BelongsToSetAssociationMixin<CountryModel, CountryId>;

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

@@ -53,6 +53,10 @@ 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,
+        // Present only when the caller explicitly included the TeamBadge association (the badge editor load);
+        // undefined on ordinary team loads.
+        badgeConfig: model.TeamBadge?.config
     });
 }

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

@@ -0,0 +1,301 @@
+import { z } from 'zod';
+export declare const BADGE_CANVAS = 200;
+export declare const BADGE_ICONS: readonly ["star", "crown", "bolt", "fire", "heart", "gem", "skull", "ghost", "anchor", "compass", "sun", "moon", "snowflake", "leaf", "seedling", "tree", "mountain", "water", "wind", "meteor", "rocket", "bell", "flag", "feather", "shield-halved", "chess-knight", "chess-rook", "hammer", "crosshairs", "medal", "trophy", "award", "volleyball", "dragon", "cat", "crow", "turtle", "unicorn", "horse", "dove", "fish", "paw", "spider", "otter", "frog", "dog"];
+export type BadgeIconName = typeof BADGE_ICONS[number];
+export declare const BADGE_TEXT_FONTS: readonly ["sans", "wide", "mono", "serif", "block", "permanentMarker", "kaushanScript", "russoOne", "teko", "saira", "michroma", "zillaSlab", "changaOne", "stardosStencil", "wallpoet", "orbitron", "tourney", "bebasNeue", "anton", "jersey25"];
+export type BadgeTextFont = typeof BADGE_TEXT_FONTS[number];
+export declare const BADGE_SHAPES: readonly ["star5-solid", "star5-slim-solid", "star6-solid", "cross-solid", "star5-outline", "star5-slim-outline", "star6-outline", "cross-outline", "pentagon-solid", "hexagon-solid", "octagon-solid", "pentagon-outline", "hexagon-outline", "octagon-outline", "square-solid", "triangle-solid", "diamond-solid", "square-outline", "triangle-outline", "diamond-outline", "rectangle-solid", "burst-solid", "trapezoid-solid", "rectangle-outline", "burst-outline", "trapezoid-outline", "circle-solid", "heptagon-solid", "nonagon-solid", "ellipse-solid", "parallelogram-solid", "heart-solid", "moon-solid", "semicircle-solid", "triangle-right-solid", "triangle-tall-solid", "trapezoid-tall-solid", "kite-solid"];
+export type BadgeShapeName = typeof BADGE_SHAPES[number];
+declare const shapeLayer: z.ZodObject<{
+    x: z.ZodNumber;
+    y: z.ZodNumber;
+    size: z.ZodNumber;
+    rotation: z.ZodNumber;
+    type: z.ZodLiteral<"shape">;
+    shape: z.ZodString;
+    colors: z.ZodArray<z.ZodString>;
+}, z.core.$strip>;
+declare const iconLayer: z.ZodObject<{
+    x: z.ZodNumber;
+    y: z.ZodNumber;
+    size: z.ZodNumber;
+    rotation: z.ZodNumber;
+    type: z.ZodLiteral<"icon">;
+    icon: z.ZodEnum<{
+        star: "star";
+        crown: "crown";
+        bolt: "bolt";
+        fire: "fire";
+        heart: "heart";
+        gem: "gem";
+        skull: "skull";
+        ghost: "ghost";
+        anchor: "anchor";
+        compass: "compass";
+        sun: "sun";
+        moon: "moon";
+        snowflake: "snowflake";
+        leaf: "leaf";
+        seedling: "seedling";
+        tree: "tree";
+        mountain: "mountain";
+        water: "water";
+        wind: "wind";
+        meteor: "meteor";
+        rocket: "rocket";
+        bell: "bell";
+        flag: "flag";
+        feather: "feather";
+        "shield-halved": "shield-halved";
+        "chess-knight": "chess-knight";
+        "chess-rook": "chess-rook";
+        hammer: "hammer";
+        crosshairs: "crosshairs";
+        medal: "medal";
+        trophy: "trophy";
+        award: "award";
+        volleyball: "volleyball";
+        dragon: "dragon";
+        cat: "cat";
+        crow: "crow";
+        turtle: "turtle";
+        unicorn: "unicorn";
+        horse: "horse";
+        dove: "dove";
+        fish: "fish";
+        paw: "paw";
+        spider: "spider";
+        otter: "otter";
+        frog: "frog";
+        dog: "dog";
+    }>;
+    color: z.ZodString;
+}, z.core.$strip>;
+declare const textLayer: z.ZodObject<{
+    x: z.ZodNumber;
+    y: z.ZodNumber;
+    size: z.ZodNumber;
+    rotation: z.ZodNumber;
+    type: z.ZodLiteral<"text">;
+    text: z.ZodString;
+    font: z.ZodEnum<{
+        block: "block";
+        sans: "sans";
+        wide: "wide";
+        mono: "mono";
+        serif: "serif";
+        permanentMarker: "permanentMarker";
+        kaushanScript: "kaushanScript";
+        russoOne: "russoOne";
+        teko: "teko";
+        saira: "saira";
+        michroma: "michroma";
+        zillaSlab: "zillaSlab";
+        changaOne: "changaOne";
+        stardosStencil: "stardosStencil";
+        wallpoet: "wallpoet";
+        orbitron: "orbitron";
+        tourney: "tourney";
+        bebasNeue: "bebasNeue";
+        anton: "anton";
+        jersey25: "jersey25";
+    }>;
+    color: z.ZodString;
+}, z.core.$strip>;
+export declare const BadgeLayerSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    x: z.ZodNumber;
+    y: z.ZodNumber;
+    size: z.ZodNumber;
+    rotation: z.ZodNumber;
+    type: z.ZodLiteral<"shape">;
+    shape: z.ZodString;
+    colors: z.ZodArray<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    x: z.ZodNumber;
+    y: z.ZodNumber;
+    size: z.ZodNumber;
+    rotation: z.ZodNumber;
+    type: z.ZodLiteral<"icon">;
+    icon: z.ZodEnum<{
+        star: "star";
+        crown: "crown";
+        bolt: "bolt";
+        fire: "fire";
+        heart: "heart";
+        gem: "gem";
+        skull: "skull";
+        ghost: "ghost";
+        anchor: "anchor";
+        compass: "compass";
+        sun: "sun";
+        moon: "moon";
+        snowflake: "snowflake";
+        leaf: "leaf";
+        seedling: "seedling";
+        tree: "tree";
+        mountain: "mountain";
+        water: "water";
+        wind: "wind";
+        meteor: "meteor";
+        rocket: "rocket";
+        bell: "bell";
+        flag: "flag";
+        feather: "feather";
+        "shield-halved": "shield-halved";
+        "chess-knight": "chess-knight";
+        "chess-rook": "chess-rook";
+        hammer: "hammer";
+        crosshairs: "crosshairs";
+        medal: "medal";
+        trophy: "trophy";
+        award: "award";
+        volleyball: "volleyball";
+        dragon: "dragon";
+        cat: "cat";
+        crow: "crow";
+        turtle: "turtle";
+        unicorn: "unicorn";
+        horse: "horse";
+        dove: "dove";
+        fish: "fish";
+        paw: "paw";
+        spider: "spider";
+        otter: "otter";
+        frog: "frog";
+        dog: "dog";
+    }>;
+    color: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    x: z.ZodNumber;
+    y: z.ZodNumber;
+    size: z.ZodNumber;
+    rotation: z.ZodNumber;
+    type: z.ZodLiteral<"text">;
+    text: z.ZodString;
+    font: z.ZodEnum<{
+        block: "block";
+        sans: "sans";
+        wide: "wide";
+        mono: "mono";
+        serif: "serif";
+        permanentMarker: "permanentMarker";
+        kaushanScript: "kaushanScript";
+        russoOne: "russoOne";
+        teko: "teko";
+        saira: "saira";
+        michroma: "michroma";
+        zillaSlab: "zillaSlab";
+        changaOne: "changaOne";
+        stardosStencil: "stardosStencil";
+        wallpoet: "wallpoet";
+        orbitron: "orbitron";
+        tourney: "tourney";
+        bebasNeue: "bebasNeue";
+        anton: "anton";
+        jersey25: "jersey25";
+    }>;
+    color: z.ZodString;
+}, z.core.$strip>], "type">;
+export declare const BADGE_MAX_LAYERS = 25;
+export declare const BadgeSchema: z.ZodObject<{
+    layers: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        x: z.ZodNumber;
+        y: z.ZodNumber;
+        size: z.ZodNumber;
+        rotation: z.ZodNumber;
+        type: z.ZodLiteral<"shape">;
+        shape: z.ZodString;
+        colors: z.ZodArray<z.ZodString>;
+    }, z.core.$strip>, z.ZodObject<{
+        x: z.ZodNumber;
+        y: z.ZodNumber;
+        size: z.ZodNumber;
+        rotation: z.ZodNumber;
+        type: z.ZodLiteral<"icon">;
+        icon: z.ZodEnum<{
+            star: "star";
+            crown: "crown";
+            bolt: "bolt";
+            fire: "fire";
+            heart: "heart";
+            gem: "gem";
+            skull: "skull";
+            ghost: "ghost";
+            anchor: "anchor";
+            compass: "compass";
+            sun: "sun";
+            moon: "moon";
+            snowflake: "snowflake";
+            leaf: "leaf";
+            seedling: "seedling";
+            tree: "tree";
+            mountain: "mountain";
+            water: "water";
+            wind: "wind";
+            meteor: "meteor";
+            rocket: "rocket";
+            bell: "bell";
+            flag: "flag";
+            feather: "feather";
+            "shield-halved": "shield-halved";
+            "chess-knight": "chess-knight";
+            "chess-rook": "chess-rook";
+            hammer: "hammer";
+            crosshairs: "crosshairs";
+            medal: "medal";
+            trophy: "trophy";
+            award: "award";
+            volleyball: "volleyball";
+            dragon: "dragon";
+            cat: "cat";
+            crow: "crow";
+            turtle: "turtle";
+            unicorn: "unicorn";
+            horse: "horse";
+            dove: "dove";
+            fish: "fish";
+            paw: "paw";
+            spider: "spider";
+            otter: "otter";
+            frog: "frog";
+            dog: "dog";
+        }>;
+        color: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+        x: z.ZodNumber;
+        y: z.ZodNumber;
+        size: z.ZodNumber;
+        rotation: z.ZodNumber;
+        type: z.ZodLiteral<"text">;
+        text: z.ZodString;
+        font: z.ZodEnum<{
+            block: "block";
+            sans: "sans";
+            wide: "wide";
+            mono: "mono";
+            serif: "serif";
+            permanentMarker: "permanentMarker";
+            kaushanScript: "kaushanScript";
+            russoOne: "russoOne";
+            teko: "teko";
+            saira: "saira";
+            michroma: "michroma";
+            zillaSlab: "zillaSlab";
+            changaOne: "changaOne";
+            stardosStencil: "stardosStencil";
+            wallpoet: "wallpoet";
+            orbitron: "orbitron";
+            tourney: "tourney";
+            bebasNeue: "bebasNeue";
+            anton: "anton";
+            jersey25: "jersey25";
+        }>;
+        color: z.ZodString;
+    }, z.core.$strip>], "type">>;
+}, z.core.$strip>;
+export type BadgeConfig = z.infer<typeof BadgeSchema>;
+export type BadgeLayer = z.infer<typeof BadgeLayerSchema>;
+export type BadgeShapeLayer = z.infer<typeof shapeLayer>;
+export type BadgeIconLayer = z.infer<typeof iconLayer>;
+export type BadgeTextLayer = z.infer<typeof textLayer>;
+export {};

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

@@ -0,0 +1,93 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BadgeSchema = exports.BADGE_MAX_LAYERS = exports.BadgeLayerSchema = exports.BADGE_SHAPES = exports.BADGE_TEXT_FONTS = exports.BADGE_ICONS = exports.BADGE_CANVAS = void 0;
+const zod_1 = require("zod");
+// 6-digit hex (#rrggbb) or 8-digit hex with alpha (#rrggbbaa), the same convention as the jersey colours (the
+// 8-digit form comes from the UI's opacity-enabled colour pickers; SVG fills render both).
+const hexColor = zod_1.z.string().regex(/^#[0-9a-fA-F]{6}([0-9a-fA-F]{2})?$/, 'INVALID_HEX_COLOR');
+// The badge canvas is a fixed square coordinate space. Layer x/y are the layer's centre in canvas units and
+// `size` is the layer's height in the same units; positions may overhang the canvas a little (clipped at render).
+exports.BADGE_CANVAS = 200;
+// Curated FontAwesome icon names offered as badge layers (owner decision 2026-08-31: curated set, not a full
+// catalog). The UI maps each name to its solid-icon path data (view/badge/badge-icons.ts, a Record keyed by this
+// type so the two lists cannot drift); this list is what the API validates against.
+exports.BADGE_ICONS = [
+    'star', 'crown', 'bolt', 'fire', 'heart', 'gem', 'skull', 'ghost', 'anchor', 'compass',
+    'sun', 'moon', 'snowflake', 'leaf', 'seedling', 'tree', 'mountain', 'water', 'wind', 'meteor',
+    'rocket', 'bell', 'flag', 'feather', 'shield-halved', 'chess-knight', 'chess-rook', 'hammer', 'crosshairs',
+    'medal', 'trophy', 'award', 'volleyball', 'dragon', 'cat', 'crow', 'turtle', 'unicorn', 'horse', 'dove',
+    'fish', 'paw', 'spider', 'otter', 'frog', 'dog'
+];
+// Text layers offer the same 20 faces as the jersey number editor (JERSEY_FONT_ALL): five generic stacks, then
+// the fifteen display families. The jersey renders its number from GENERATED DIGIT GLYPHS because it lives in a
+// data-uri <img> where @font-face does not load; the badge canvas is inline SVG in the document, so it uses the
+// real webfonts instead, which also means badge text is not limited to the digits those glyph sets cover.
+exports.BADGE_TEXT_FONTS = [
+    'sans', 'wide', 'mono', 'serif', 'block',
+    'permanentMarker', 'kaushanScript', 'russoOne', 'teko', 'saira', 'michroma', 'zillaSlab', 'changaOne',
+    'stardosStencil', 'wallpoet', 'orbitron', 'tourney', 'bebasNeue', 'anton', 'jersey25'
+];
+// Basic geometric shapes (VolleyballSimUI/public/shapes), extracted from the two source sets 2026-08-31. The
+// crest sets are positional (shield-a01, ribbon-07), but these are named, so the vocabulary is spelled out
+// rather than pattern-matched: this list IS the allow list, and every entry has a file of the same name.
+// `-outline` is the hollow cut, whose interior is a real hole in the path (so layers underneath show through,
+// no transparent fill slot needed). Order is the picker order, grouped by family.
+// The rounded-corner cut of every shape, plus the split square and the pie, were dropped by the owner
+// 2026-08-31; only the sharp cuts ship.
+exports.BADGE_SHAPES = [
+    'star5-solid', 'star5-slim-solid', 'star6-solid', 'cross-solid',
+    'star5-outline', 'star5-slim-outline', 'star6-outline', 'cross-outline',
+    'pentagon-solid', 'hexagon-solid', 'octagon-solid',
+    'pentagon-outline', 'hexagon-outline', 'octagon-outline',
+    'square-solid', 'triangle-solid', 'diamond-solid',
+    'square-outline', 'triangle-outline', 'diamond-outline',
+    'rectangle-solid', 'burst-solid', 'trapezoid-solid',
+    'rectangle-outline', 'burst-outline', 'trapezoid-outline',
+    'circle-solid', 'heptagon-solid', 'nonagon-solid', 'ellipse-solid', 'parallelogram-solid',
+    'heart-solid', 'moon-solid', 'semicircle-solid', 'triangle-right-solid', 'triangle-tall-solid',
+    'trapezoid-tall-solid', 'kite-solid'
+];
+// The extracted vector sets in VolleyballSimUI/public/shields + public/ribbons + public/shapes:
+// shield-a01..a17 / shield-b01..b16, each -solid|-bordered|-outline; ribbon-01..ribbon-49; and shape-<name>
+// for every name in BADGE_SHAPES.
+const CREST_ID = /^(shield-(a(0[1-9]|1[0-7])|b(0[1-9]|1[0-6]))-(solid|bordered|outline)|ribbon-(0[1-9]|[1-4][0-9]))$/;
+const BASIC_ID = new RegExp(`^shape-(${exports.BADGE_SHAPES.join('|')})$`);
+const shapeId = zod_1.z.string().refine(v => CREST_ID.test(v) || BASIC_ID.test(v), 'INVALID_BADGE_SHAPE');
+const layerBase = {
+    x: zod_1.z.number().min(-100).max(300),
+    y: zod_1.z.number().min(-100).max(300),
+    size: zod_1.z.number().min(4).max(400),
+    rotation: zod_1.z.number().min(-180).max(180)
+};
+// One colour per DISTINCT fill in the source art (solid shields 1, bordered 3, ribbons up to 4, basic shapes 1),
+// applied in the order the fills first appear in the file. Extra entries are ignored at render; missing ones
+// fall back to the source colour.
+const shapeLayer = zod_1.z.object({
+    type: zod_1.z.literal('shape'),
+    shape: shapeId,
+    colors: zod_1.z.array(hexColor).min(1).max(6),
+    ...layerBase
+});
+const iconLayer = zod_1.z.object({
+    type: zod_1.z.literal('icon'),
+    icon: zod_1.z.enum(exports.BADGE_ICONS),
+    color: hexColor,
+    ...layerBase
+});
+const textLayer = zod_1.z.object({
+    type: zod_1.z.literal('text'),
+    text: zod_1.z.string().min(1).max(24),
+    font: zod_1.z.enum(exports.BADGE_TEXT_FONTS),
+    color: hexColor,
+    ...layerBase
+});
+exports.BadgeLayerSchema = zod_1.z.discriminatedUnion('type', [shapeLayer, iconLayer, textLayer]);
+// The most layers one badge may stack. Not a technical ceiling (25 layers is under 3 KB of jsonb and a trivial
+// number of SVG paths): past roughly a dozen you cannot tell the elements apart at the size a crest is shown,
+// and the one-step-per-click reordering gets tedious. Exported so the editor gates on the SAME number the save
+// validates against, rather than keeping its own copy that can drift.
+exports.BADGE_MAX_LAYERS = 25;
+// The full team badge: an ordered stack of layers (index 0 renders first, i.e. at the back).
+exports.BadgeSchema = zod_1.z.object({
+    layers: zod_1.z.array(exports.BadgeLayerSchema).min(1).max(exports.BADGE_MAX_LAYERS)
+});

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

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

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

@@ -16,6 +16,8 @@ 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("./badge"), 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;