xpt-shared-types 1.20.0 → 1.25.0

package/dist/generated/enums.d.ts

@@ -62,6 +62,8 @@ export type TournamentParticipantStatus = "registered" | "active" | "eliminated"
 export type TournamentRoleRole = "moderator" | "admin";
 /** `Tournament.teamSize` */
 export type TournamentTeamSize = "one" | "two" | "three" | "four" | "five";
+/** `TournamentTemplate.teamSize` */
+export type TournamentTemplateTeamSize = "one" | "two" | "three" | "four" | "five";
 /** `Tournament.type` */
 export type TournamentType = "Single Elimination" | "League" | "Double Elimination";
 /** `Tournament.visibility` */

package/dist/generated/inputs.d.ts

@@ -1,5 +1,5 @@
 import type { BlocksContent, MediaInput, RelationInput } from '../contracts';
-import type { AdminActionTargetType, FaqCategory, FriendshipStatus, GameAccountCode, GameAccountVerification, GameGenre, GameRequestCustomLobbies, GameRequestGenre, GameRequestTeamPlay, GameVisibility, MatchDisputeReason, MatchLobbyStatus, MatchResultType, MatchRound, MatchStreamPlatform, MatchWinnerSlot, PlatformCode, PlayerBanScope, ReferralStatus, TeamCurrentStatus, TeamInviteStatus, TeamInviteTeamRole, TeamPlayerTeamRole, TournamentAccess, TournamentCurrentStatus, TournamentInviteStatus, TournamentJoinRequestEntryType, TournamentJoinRequestStatus, TournamentParticipantEntryType, TournamentParticipantStatus, TournamentRoleRole, TournamentTeamSize, TournamentType, TournamentVisibility, UserGameAccountVerificationMethod, UserTransactionStripeStatus, UserTransactionType } from './enums';
+import type { AdminActionTargetType, FaqCategory, FriendshipStatus, GameAccountCode, GameAccountVerification, GameGenre, GameRequestCustomLobbies, GameRequestGenre, GameRequestTeamPlay, GameVisibility, MatchDisputeReason, MatchLobbyStatus, MatchResultType, MatchRound, MatchStreamPlatform, MatchWinnerSlot, PlatformCode, PlayerBanScope, ReferralStatus, TeamCurrentStatus, TeamInviteStatus, TeamInviteTeamRole, TeamPlayerTeamRole, TournamentAccess, TournamentCurrentStatus, TournamentInviteStatus, TournamentJoinRequestEntryType, TournamentJoinRequestStatus, TournamentParticipantEntryType, TournamentParticipantStatus, TournamentRoleRole, TournamentTeamSize, TournamentTemplateTeamSize, TournamentType, TournamentVisibility, UserGameAccountVerificationMethod, UserTransactionStripeStatus, UserTransactionType } from './enums';
 /** Write payload for `about`. */
 export interface AboutInput {
     heroTitle?: string;
@@ -77,6 +77,7 @@ export interface GameAccountInput {
     name?: string;
     code?: GameAccountCode;
     verification?: GameAccountVerification;
+    sortOrder?: number;
     tournaments?: RelationInput | RelationInput[];
     user_game_accounts?: RelationInput | RelationInput[];
     imgThumb?: MediaInput;
@@ -170,6 +171,7 @@ export interface MatchInput {
     disputeReason?: MatchDisputeReason;
     disputeNote?: string;
     disputedBy?: RelationInput;
+    resultRecordedBy?: RelationInput;
 }
 /** Write payload for `match-message`. */
 export interface MatchMessageInput {
@@ -345,6 +347,9 @@ export interface TournamentInput {
     gameAccount?: RelationInput;
     tournament_stages?: unknown;
     prizesDistributed?: boolean;
+    entryFeesCollected?: number;
+    entryFeesSettledAt?: string;
+    hostXpAwarded?: number;
     discordUrl?: string;
     twitterUrl?: string;
     twitchUrl?: string;
@@ -390,6 +395,7 @@ export interface TournamentParticipantInput {
     status?: TournamentParticipantStatus;
     captainUser?: RelationInput;
     membersSnapshot?: unknown;
+    feePaid?: number;
 }
 /** Write payload for `tournament-preset-banner`. */
 export interface TournamentPresetBannerInput {
@@ -401,6 +407,27 @@ export interface TournamentRoleInput {
     users_permissions_user?: RelationInput;
     tournament?: RelationInput;
 }
+/** Write payload for `tournament-template`. */
+export interface TournamentTemplateInput {
+    name?: string;
+    host?: RelationInput;
+    game?: RelationInput;
+    participants?: number;
+    teamSize?: TournamentTemplateTeamSize;
+    entryFee?: number;
+    checkInTime?: number;
+    hasThirdPlace?: boolean;
+    hasMatchLobby?: boolean;
+    rules?: string;
+    platform?: RelationInput;
+    gameAccount?: RelationInput;
+    region?: RelationInput;
+    imgMain?: MediaInput;
+    prizes?: unknown;
+    isDefault?: boolean;
+    useCount?: number;
+    lastUsedAt?: string;
+}
 /** Write payload for `user`. */
 export interface UserInput {
     username?: string;

package/dist/generated/models.d.ts

@@ -1,5 +1,5 @@
 import type { BlocksContent, StrapiDocument, StrapiMedia, UserRole } from '../contracts';
-import type { AdminActionTargetType, FaqCategory, FriendshipStatus, GameAccountCode, GameAccountVerification, GameGenre, GameRequestCustomLobbies, GameRequestGenre, GameRequestTeamPlay, GameVisibility, MatchDisputeReason, MatchLobbyStatus, MatchResultType, MatchRound, MatchStreamPlatform, MatchWinnerSlot, PlatformCode, PlayerBanScope, ReferralStatus, TeamCurrentStatus, TeamInviteStatus, TeamInviteTeamRole, TeamPlayerTeamRole, TournamentAccess, TournamentCurrentStatus, TournamentInviteStatus, TournamentJoinRequestEntryType, TournamentJoinRequestStatus, TournamentParticipantEntryType, TournamentParticipantStatus, TournamentRoleRole, TournamentTeamSize, TournamentType, TournamentVisibility, UserGameAccountVerificationMethod, UserTransactionStripeStatus, UserTransactionType } from './enums';
+import type { AdminActionTargetType, FaqCategory, FriendshipStatus, GameAccountCode, GameAccountVerification, GameGenre, GameRequestCustomLobbies, GameRequestGenre, GameRequestTeamPlay, GameVisibility, MatchDisputeReason, MatchLobbyStatus, MatchResultType, MatchRound, MatchStreamPlatform, MatchWinnerSlot, PlatformCode, PlayerBanScope, ReferralStatus, TeamCurrentStatus, TeamInviteStatus, TeamInviteTeamRole, TeamPlayerTeamRole, TournamentAccess, TournamentCurrentStatus, TournamentInviteStatus, TournamentJoinRequestEntryType, TournamentJoinRequestStatus, TournamentParticipantEntryType, TournamentParticipantStatus, TournamentRoleRole, TournamentTeamSize, TournamentTemplateTeamSize, TournamentType, TournamentVisibility, UserGameAccountVerificationMethod, UserTransactionStripeStatus, UserTransactionType } from './enums';
 /** `about` */
 export interface About extends StrapiDocument {
     heroTitle?: string | null;
@@ -77,6 +77,7 @@ export interface GameAccount extends StrapiDocument {
     name?: string | null;
     code?: GameAccountCode | null;
     verification?: GameAccountVerification | null;
+    sortOrder?: number | null;
     tournaments?: Tournament[];
     user_game_accounts?: UserGameAccount[];
     imgThumb?: StrapiMedia | null;
@@ -170,6 +171,7 @@ export interface Match extends StrapiDocument {
     disputeReason?: MatchDisputeReason | null;
     disputeNote?: string | null;
     disputedBy?: User | null;
+    resultRecordedBy?: User | null;
 }
 /** `match-message` */
 export interface MatchMessage extends StrapiDocument {
@@ -345,6 +347,9 @@ export interface Tournament extends StrapiDocument {
     gameAccount?: GameAccount | null;
     tournament_stages?: unknown | null;
     prizesDistributed?: boolean | null;
+    entryFeesCollected?: number | null;
+    entryFeesSettledAt?: string | null;
+    hostXpAwarded?: number | null;
     discordUrl?: string | null;
     twitterUrl?: string | null;
     twitchUrl?: string | null;
@@ -390,6 +395,7 @@ export interface TournamentParticipant extends StrapiDocument {
     status?: TournamentParticipantStatus | null;
     captainUser?: User | null;
     membersSnapshot?: unknown | null;
+    feePaid?: number | null;
 }
 /** `tournament-preset-banner` */
 export interface TournamentPresetBanner extends StrapiDocument {
@@ -401,6 +407,27 @@ export interface TournamentRole extends StrapiDocument {
     users_permissions_user?: User | null;
     tournament?: Tournament | null;
 }
+/** `tournament-template` */
+export interface TournamentTemplate extends StrapiDocument {
+    name?: string | null;
+    host?: User | null;
+    game?: Game | null;
+    participants?: number | null;
+    teamSize?: TournamentTemplateTeamSize | null;
+    entryFee?: number | null;
+    checkInTime?: number | null;
+    hasThirdPlace?: boolean | null;
+    hasMatchLobby?: boolean | null;
+    rules?: string | null;
+    platform?: Platform | null;
+    gameAccount?: GameAccount | null;
+    region?: Region | null;
+    imgMain?: StrapiMedia | null;
+    prizes?: unknown | null;
+    isDefault?: boolean | null;
+    useCount?: number | null;
+    lastUsedAt?: string | null;
+}
 /** `user` */
 export interface User extends StrapiDocument {
     username?: string | null;

package/dist/manual/experience.d.ts

@@ -0,0 +1,52 @@
+/**
+ * The experience ladder — EXP, which is **not** XPT.
+ *
+ * XPT is the spendable currency: it lives on the user as `xptCoins`, moves
+ * through `createWalletTransaction`, and leaves a ledger row. EXP is
+ * progression: it lives in `*_exp_earned` columns on the stat tables, is never
+ * spendable, and surfaces only as a level name. Nothing converts one into the
+ * other.
+ *
+ * Three independent ladders share the maths below — a player's
+ * (`user_summary_stat.total_exp_earned`), a host's
+ * (`host_summary_stat.host_exp_earned`) and a team's
+ * (`team_summary_stat.total_exp_earned`) — so a change here moves all three.
+ *
+ * It lives in the shared package because the server needs `getLevelFromExp` to
+ * notice a level *crossing* (the only EXP event worth a notification; see the
+ * note on `getLevelName`), while the client needs the same ladder to render
+ * the level bar. Two copies would drift into telling a user two different
+ * things about the same number.
+ */
+export declare const levelNames: string[];
+export declare const BASE_EXP = 500;
+export declare const EXP_MULTIPLIER = 1.25;
+/** Total EXP needed to have reached `level`. Level 1 is the floor, at 0. */
+export declare const getExpForLevel: (level: number) => number;
+/** 1-based: everyone starts at level 1, which is `levelNames[0]`. */
+export declare const getLevelFromExp: (totalExp: number, maxLevel: number) => number;
+/**
+ * `MAX_LEVEL` is the number of rungs, so every name is reachable. It was 20
+ * against 21 names, which stranded 'Zenith' at the top of a ladder nobody
+ * could finish climbing.
+ */
+export declare const MAX_LEVEL: number;
+/**
+ * `getLevelFromExp` is 1-based and `levelNames` is 0-based, so the index is
+ * `level - 1`. It used to be `levelNames[level]`, which skipped 'Beginner'
+ * entirely and greeted a brand-new account with 0 EXP as 'Novice'.
+ */
+export declare const getLevelName: (totalExp: number, maxLevel?: number) => string;
+/**
+ * Whether adding EXP moved someone up a rung, and to what.
+ *
+ * This is the only EXP event worth a notification. Awards themselves are a
+ * drip — a match is 10 EXP, so a bracket winner would collect five bells on
+ * top of the five they already get for the results — whereas a crossing is
+ * rare and is the thing the ladder exists to celebrate.
+ */
+export declare const levelCrossing: (before: number, after: number) => {
+    crossed: boolean;
+    level: number;
+    name: string;
+};

package/dist/manual/experience.js

@@ -0,0 +1,104 @@
+"use strict";
+/**
+ * The experience ladder — EXP, which is **not** XPT.
+ *
+ * XPT is the spendable currency: it lives on the user as `xptCoins`, moves
+ * through `createWalletTransaction`, and leaves a ledger row. EXP is
+ * progression: it lives in `*_exp_earned` columns on the stat tables, is never
+ * spendable, and surfaces only as a level name. Nothing converts one into the
+ * other.
+ *
+ * Three independent ladders share the maths below — a player's
+ * (`user_summary_stat.total_exp_earned`), a host's
+ * (`host_summary_stat.host_exp_earned`) and a team's
+ * (`team_summary_stat.total_exp_earned`) — so a change here moves all three.
+ *
+ * It lives in the shared package because the server needs `getLevelFromExp` to
+ * notice a level *crossing* (the only EXP event worth a notification; see the
+ * note on `getLevelName`), while the client needs the same ladder to render
+ * the level bar. Two copies would drift into telling a user two different
+ * things about the same number.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.levelCrossing = exports.getLevelName = exports.MAX_LEVEL = exports.getLevelFromExp = exports.getExpForLevel = exports.EXP_MULTIPLIER = exports.BASE_EXP = exports.levelNames = void 0;
+exports.levelNames = [
+    'Beginner',
+    'Novice',
+    'Rookie',
+    'Apprentice',
+    'Initiate',
+    'Trainee',
+    'Competitor',
+    'Contender',
+    'Veteran',
+    'Expert',
+    'Elite',
+    'Master',
+    'Grandmaster',
+    'Champion',
+    'Legend',
+    'Mythic',
+    'Godlike',
+    'Immortal',
+    'Supreme',
+    'Transcendent',
+    'Zenith',
+];
+exports.BASE_EXP = 500;
+exports.EXP_MULTIPLIER = 1.25;
+/** Total EXP needed to have reached `level`. Level 1 is the floor, at 0. */
+const getExpForLevel = (level) => {
+    if (level <= 0)
+        return 0;
+    let total = 0;
+    for (let i = 0; i < level; i++) {
+        total += Math.floor(exports.BASE_EXP * Math.pow(exports.EXP_MULTIPLIER, i));
+    }
+    return total;
+};
+exports.getExpForLevel = getExpForLevel;
+/** 1-based: everyone starts at level 1, which is `levelNames[0]`. */
+const getLevelFromExp = (totalExp, maxLevel) => {
+    let level = 1;
+    while (level < maxLevel && totalExp >= (0, exports.getExpForLevel)(level + 1)) {
+        level++;
+    }
+    return level;
+};
+exports.getLevelFromExp = getLevelFromExp;
+/**
+ * `MAX_LEVEL` is the number of rungs, so every name is reachable. It was 20
+ * against 21 names, which stranded 'Zenith' at the top of a ladder nobody
+ * could finish climbing.
+ */
+exports.MAX_LEVEL = exports.levelNames.length;
+/**
+ * `getLevelFromExp` is 1-based and `levelNames` is 0-based, so the index is
+ * `level - 1`. It used to be `levelNames[level]`, which skipped 'Beginner'
+ * entirely and greeted a brand-new account with 0 EXP as 'Novice'.
+ */
+const getLevelName = (totalExp, maxLevel = exports.MAX_LEVEL) => {
+    var _a;
+    const level = (0, exports.getLevelFromExp)(totalExp, maxLevel);
+    return (_a = exports.levelNames[level - 1]) !== null && _a !== void 0 ? _a : 'Unknown';
+};
+exports.getLevelName = getLevelName;
+/**
+ * Whether adding EXP moved someone up a rung, and to what.
+ *
+ * This is the only EXP event worth a notification. Awards themselves are a
+ * drip — a match is 10 EXP, so a bracket winner would collect five bells on
+ * top of the five they already get for the results — whereas a crossing is
+ * rare and is the thing the ladder exists to celebrate.
+ */
+const levelCrossing = (before, after) => {
+    var _a;
+    const from = (0, exports.getLevelFromExp)(before, exports.MAX_LEVEL);
+    const to = (0, exports.getLevelFromExp)(after, exports.MAX_LEVEL);
+    return {
+        crossed: to > from,
+        level: to,
+        name: (_a = exports.levelNames[to - 1]) !== null && _a !== void 0 ? _a : 'Unknown',
+    };
+};
+exports.levelCrossing = levelCrossing;

package/dist/manual/index.d.ts

@@ -2,6 +2,7 @@
  * Hand-written types that are not derived from a Strapi content type.
  */
 export * from './country';
+export * from './experience';
 export * from './gameAccountHandle';
 export * from './lobby';
 export * from './notification';
@@ -10,3 +11,5 @@ export * from './tournamentEntry';
 export * from './tournamentInvite';
 export * from './tournamentJoinRequest';
 export * from './tournamentStaff';
+export * from './tournamentTemplate';
+export * from './userUiState';

package/dist/manual/index.js

@@ -18,6 +18,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
  * Hand-written types that are not derived from a Strapi content type.
  */
 __exportStar(require("./country"), exports);
+__exportStar(require("./experience"), exports);
 __exportStar(require("./gameAccountHandle"), exports);
 __exportStar(require("./lobby"), exports);
 __exportStar(require("./notification"), exports);
@@ -26,3 +27,5 @@ __exportStar(require("./tournamentEntry"), exports);
 __exportStar(require("./tournamentInvite"), exports);
 __exportStar(require("./tournamentJoinRequest"), exports);
 __exportStar(require("./tournamentStaff"), exports);
+__exportStar(require("./tournamentTemplate"), exports);
+__exportStar(require("./userUiState"), exports);

package/dist/manual/tournamentTemplate.d.ts

@@ -0,0 +1,177 @@
+/**
+ * Tournament templates — the contract between `utils/tournamentTemplate.ts`
+ * in xpt-strapi and the create dialog's setup step, the post-publish
+ * "Save as template" prompt and the Settings → Templates page in xpt-client.
+ *
+ * A template holds settings only: never entries, dates or results. A null
+ * setting means the host chose not to save it and the XPT default applies
+ * (`resolveSetup`). Alongside the host's templates, the API derives their
+ * **last tournament per game** — the newest one taken out of draft in the
+ * last `LAST_RUN_WINDOW_DAYS` — so a host can repeat a night without ever
+ * having saved anything.
+ *
+ * What a setup carries is close to the whole publish checklist: the catalogue
+ * choice (platform and account network), the region, the banner and the prize
+ * amounts ride along with the shape and the rules. Only the date is left out,
+ * because it belongs to one event rather than to the setup.
+ *
+ * Routes (all scoped to the caller):
+ *  - `GET /tournament-templates/setups` → `{ data: TournamentSetupsResponse }`
+ *  - `POST /tournament-templates` with `SaveTemplateBody` → `{ data: TournamentTemplateSummary }`
+ *  - `PUT /tournament-templates/:id/default` → `{ data: TournamentTemplateSummary }`
+ *  - `DELETE /tournament-templates/:id`
+ *  - `POST /tournaments` accepts `entryFee`, `checkInTime`, `rules`, `region`,
+ *    `platform`, `gameAccount`, `imgMain`, `prizes` and `template` (the
+ *    documentId, for usage meta) alongside the usual fields.
+ */
+import type { StrapiMedia } from '../contracts';
+import type { TournamentTeamSize } from '../generated/enums';
+/** How far back the automatic "last tournament" looks. */
+export declare const LAST_RUN_WINDOW_DAYS = 30;
+/** Templates a host may keep; the save route refuses the next one. */
+export declare const MAX_TEMPLATES_PER_HOST = 20;
+/**
+ * The settings a host may leave out of a setup — the "Also copied" rows.
+ * `platform` covers the account network too: the two are chosen together and
+ * publish readiness counts them as one detail.
+ */
+export declare const TEMPLATE_COPY_KEYS: readonly ["entryFee", "prizes", "checkInTime", "platform", "region", "hasMatchLobby", "hasThirdPlace", "rules", "imgMain"];
+export type TemplateCopyKey = (typeof TEMPLATE_COPY_KEYS)[number];
+export type TemplateIncludeFlags = Record<TemplateCopyKey, boolean>;
+/** A catalogue row as a setup names it. */
+export interface SetupRef {
+    documentId: string;
+    name: string | null;
+}
+/** One placement's payout. The set of ranks is derived, never carried. */
+export interface SetupPrize {
+    rank: string;
+    value: number | null;
+}
+/** The banner, as the media row a new tournament reuses. */
+export interface SetupBanner {
+    id: number;
+    url: string | null;
+}
+export interface TournamentSetupFields {
+    participants: number;
+    teamSize: TournamentTeamSize;
+    /** Null: not saved, XPT default applies. */
+    entryFee: number | null;
+    /** Minutes; 0 is "no check-in". Null: not saved. */
+    checkInTime: number | null;
+    hasThirdPlace: boolean | null;
+    hasMatchLobby: boolean | null;
+    rules: string | null;
+    platform: SetupRef | null;
+    /** Rides with `platform`; the create refuses it if the catalogue has moved. */
+    gameAccount: SetupRef | null;
+    region: SetupRef | null;
+    imgMain: SetupBanner | null;
+    prizes: SetupPrize[];
+}
+/** What a blank tournament starts from, and what a null setting falls back to. */
+export declare const TOURNAMENT_SETUP_DEFAULTS: TournamentSetupFields;
+/** Enough of a game for the client to open the create dialog on it. */
+export interface SetupGame {
+    id: number;
+    documentId: string;
+    title: string | null;
+    slug: string | null;
+    imgThumb: StrapiMedia | null;
+}
+/** A saved template as the routes return it. */
+export interface TournamentTemplateSummary extends TournamentSetupFields {
+    documentId: string;
+    name: string;
+    game: SetupGame | null;
+    isDefault: boolean;
+    useCount: number;
+    lastUsedAt: string | null;
+    createdAt: string | null;
+}
+/** The host's last tournament for one game, derived at read time. */
+export interface LastRunSummary extends TournamentSetupFields {
+    documentId: string;
+    title: string;
+    slug: string;
+    game: SetupGame | null;
+    dateTime: string | null;
+    createdAt: string | null;
+}
+/** `GET /tournament-templates/setups` — templates default first, runs newest first. */
+export interface TournamentSetupsResponse {
+    templates: TournamentTemplateSummary[];
+    lastRuns: LastRunSummary[];
+}
+/** `POST /tournament-templates`. Missing include flags read as ticked. */
+export interface SaveTemplateBody {
+    tournamentDocumentId: string;
+    name: string;
+    include?: Partial<TemplateIncludeFlags>;
+    isDefault?: boolean;
+}
+/** What the setup step offers, and what the details step was prefilled from. */
+export type SetupChoice = {
+    kind: 'template';
+    template: TournamentTemplateSummary;
+} | {
+    kind: 'lastRun';
+    lastRun: LastRunSummary;
+} | {
+    kind: 'blank';
+};
+/** Every setting resolved: nulls replaced by the XPT default. */
+export declare function resolveSetup(fields: Partial<TournamentSetupFields> | null | undefined): TournamentSetupFields;
+/**
+ * The copy keys this setup actually has something for. A setting the host
+ * unticked when saving, or never set on the tournament, carries nothing — so
+ * the "Also copied" list offers it no row rather than a tickable blank.
+ */
+export declare function copyableSetupKeys(fields: Partial<TournamentSetupFields> | null | undefined): TemplateCopyKey[];
+/** The total a setup's prize amounts add up to. */
+export declare const setupPrizePot: (prizes: SetupPrize[] | null | undefined) => number;
+/** The tournament title rules' limit; a bumped name has to stay inside it. */
+export declare const MAX_TOURNAMENT_NAME = 50;
+/**
+ * The name a tournament started from a setup gets. A trailing `#N` is bumped
+ * (`Friday Night Ops #3` → `Friday Night Ops #4`); a name without one is
+ * treated as the first of its series and becomes `#2`. Either way the host
+ * sees a name they can keep or type over, and never one that silently
+ * duplicates the tournament it came from.
+ */
+export declare function nextTournamentName(name: string): string;
+/** A template name from a tournament title: the trailing `#N`, if any, dropped. */
+export declare function templateNameFrom(title: string): string;
+/** The setups offered for one game: its templates and, if any, its last run. */
+export declare function setupsForGame(setups: TournamentSetupsResponse | null | undefined, gameDocumentId: string | null | undefined): {
+    templates: TournamentTemplateSummary[];
+    lastRun: LastRunSummary | null;
+};
+/** Badge counts for the game grid: templates for the game plus its last run. */
+export declare function setupCountByGame(setups: TournamentSetupsResponse | null | undefined): Record<string, number>;
+/**
+ * What the setup step starts on: the default template if the game has one,
+ * else the game's last run, else blank — so Continue is a single tap.
+ */
+export declare function preselectSetup(templates: TournamentTemplateSummary[], lastRun: LastRunSummary | null | undefined): SetupChoice;
+/** The setup fields of a choice, or null for blank. */
+export declare function setupOfChoice(choice: SetupChoice): TournamentSetupFields | null;
+/** The name a choice was made under, for the provenance strip. */
+export declare function nameOfChoice(choice: SetupChoice): string | null;
+export interface DescribeSetupOptions {
+    /** `players` or `teams` for the team size. */
+    entryNoun: (teamSize: TournamentTeamSize) => string;
+    /** `1v1` … `5v5`. */
+    teamSizeLabel: (teamSize: TournamentTeamSize) => string;
+    /** `Free entry`, `50 XPT` — the app's own money formatting. */
+    feeLabel: (fee: number) => string;
+    /** Mention rules when the setup carries them. Default true. */
+    withRules?: boolean;
+}
+/**
+ * The detail line under a setup: `16 teams · 2v2 · 50 XPT · check-in 30 min
+ * · rules`. Nulls read as their defaults. The labels come from the caller
+ * so this package does not carry the app's copy.
+ */
+export declare function describeSetup(fields: Partial<TournamentSetupFields> | null | undefined, options: DescribeSetupOptions): string;