Image export · Modules

I

2 modules · 14 exports · 0 repositories · 0 e2e tests · 0 routes

ModulesPermissions

Who imports who · hover a node

RunComps

app/features/img-export/core/RunComps.ts

No overview comment at the top of the file.

Imports

no other modules

Used by

1 loader1 component

Types

interface

CompObservation

no JSDoc:8

export interface CompObservation {
	/** User id when known, otherwise the ingested scoreboard name */
	playerKey: string;
	weaponSplId: MainWeaponId;
	/** Chronological index of the map the weapon was played in */
	mapOrder: number;
}

Loaders/to/:id/teams/:tid/comps

Componentsscanner/montage-comps.ts

Functions & values

function

buildComp

:20

Each player contributes their most played weapon (ties: most recent). Weapon id order, Tacticooler weapons last. Over {@link COMP_SIZE} players, the ones with the most maps make the comp.

export function buildComp(observations: CompObservation[]): MainWeaponId[]

Unit tests (5)

• returns an empty comp for no observations
• picks each player's most played weapon
• breaks a most played tie by the most recently played weapon
• sorts the comp by weapon id with Tacticooler weapons last
• keeps the players that played the most maps when there are more than four

Loaders/to/:id/teams/:tid/comps

Componentsscanner/montage-comps.ts

function

mapObservations

:46

One map's reported and ingested weapon rows as observations. Ingested rows duplicating a report are dropped (same user, or an unlinked row whose weapon a report already covers, as a multiset).

export function mapObservations({
	mapOrder,
	reported,
	ingested,
}: {
	mapOrder: number;
	reported: Array<{ userId: number; weaponSplId: MainWeaponId }>;
	ingested: Array<{
		name: string;
		userId?: number;
		weaponSplId: MainWeaponId | null;
	}>;
}): CompObservation[]

Unit tests (4)

• keeps reported weapons and ingested rows of other players
• drops
  • an ingested row linked to a user that already reported
  • an unlinked ingested row whose weapon a report accounts for, counting duplicates as a multiset
• skips ingested rows without a weapon

Loaders/to/:id/teams/:tid/comps

SeasonSummary

app/features/img-export/core/SeasonSummary.ts

No overview comment at the top of the file.

Imports

Seasons

Used by

2 loaders1 route

Types

interface

SetScore

no JSDoc:16

export interface SetScore {
	ownScore: number;
	opponentScore: number;
}

Only used inside the module

interface

TournamentRun

no JSDoc:148

export interface TournamentRun {
	/** 1 = X (best) … 9 = C. Null (no calculated tier) ranks below every tiered tournament. */
	tier: number | null;
	placement: number;
	teamsCount: number;
	/** Average end of season SP of the top 8 placers; null when none had a calculated skill. */
	topEightAvgSp: number | null;
}

Only used inside the module

Functions & values

function

longestWinStreak

:22

Longest run of consecutive set wins; sets must be in chronological order.

export function longestWinStreak(sets: SetScore[]): number

Unit tests (4)

• returns
  • 0 for no sets
  • 0 when every set was lost
• counts
  • consecutive wins only
  • a streak lasting until the end

Loaders/u/:identifier/seasons/summary-graphic

function

clutchRecord

:39

Win record in sets decided by one map (4-3 in SendouQ, 2-1/3-2 in tournaments).

export function clutchRecord(sets: SetScore[]): { won: number; total: number }

Unit tests (2)

• returns zeros for no sets
• only counts sets decided by one map

Loaders/u/:identifier/seasons/summary-graphic

function

bestStage

:52

Best winrate stage across modes; stages under the maps-played threshold are excluded so a lucky 2-0 can't win.

export function bestStage(
	stages: Partial<
		Record<
			StageId,
			Partial<Record<ModeShort, { wins: number; losses: number }>>
		>
	>,
): { stageId: StageId; winratePercentage: number } | undefined

Unit tests (4)

• returns undefined when no stage has enough maps played
• aggregates winrate across modes
• picks the stage with the highest winrate among qualified ones
• does not let a low sample size stage win over a qualified one

Loaders/u/:identifier/seasons/u/:identifier/seasons/summary-graphic

function

mostPlayedStage

:83

Stage with the most maps played across modes, higher winrate breaking ties; undefined when no maps were played.

export function mostPlayedStage(
	stages: Partial<
		Record<
			StageId,
			Partial<Record<ModeShort, { wins: number; losses: number }>>
		>
	>,
): { stageId: StageId; winratePercentage: number } | undefined

Unit tests (3)

• returns undefined when no maps were played
• picks the stage with the most maps across modes
• breaks a tie by winrate

Loaders/u/:identifier/seasons

function

topModeUsage

:117

Mode with the most maps played across stages, with its share of all maps played; null when no maps were played.

export function topModeUsage(
	stages: Partial<
		Record<
			StageId,
			Partial<Record<ModeShort, { wins: number; losses: number }>>
		>
	>,
): { mode: ModeShort; usagePercentage: number } | null

Unit tests (2)

• returns null when no maps were played
• sums maps of a mode across stages

Loaders/u/:identifier/seasons

function

bestTournamentRun

:169

The best tournament run by {@link tournamentRunScore}.

export function bestTournamentRun<T extends TournamentRun>(
	runs: T[],
): T | undefined

Unit tests (3)

• returns undefined for no runs
• picks
  • the run with the highest score
  • the stronger field among runs tied by tier and placement

Loaders/u/:identifier/seasons/summary-graphic

function

topWeaponUsages

:176

Most used weapons with their share of all reported weapon occurrences, most used first.

export function topWeaponUsages(
	reportedWeapons: Array<{ weaponSplId: MainWeaponId; count: number }>,
): Array<{ weaponSplId: MainWeaponId; usagePercentage: number }>

Unit tests (2)

• returns
  • empty array for no reported weapons
  • the most used weapons with their usage share

Loaders/u/:identifier/seasons/u/:identifier/seasons/summary-graphic

function

isSeasonFinished

:192

Whether the season has ended.

export function isSeasonFinished(season: number, date = new Date())

Routes/u/:identifier/seasons

function

canExportSeasonSummary

:207

Only the profile owner can export, with a non-approximate skill for a finished season. Supporters can export any finished season, others only per {@link isSeasonExportableByAll}.

export function canExportSeasonSummary({
	loggedInUser,
	profileUserId,
	season,
	seasonsParticipatedIn,
	hasCalculatedSkill,
	date = new Date(),
}: {
	loggedInUser?: { id: number; roles: Role[] };
	profileUserId: number;
	season: number;
	seasonsParticipatedIn: number[];
	hasCalculatedSkill: boolean;
	date?: Date;
}): boolean

Unit tests (9)

• allows
  • the profile owner to export the latest finished season during off-season
  • a supporter to export any finished participated season, also mid-season
• disallows
  • exporting someone else's profile
  • without being logged in
  • a season not participated in
  • without a calculated skill
  • a non-supporter exporting an older season
  • exporting an ongoing season
  • a supporter exporting an ongoing season

Loaders/u/:identifier/seasons/summary-graphic

Routes/u/:identifier/seasons

Unit tests not about one export (8)

• lets tier dominate over placement quality
• rewards better placement within the same tier
• scores an untiered tournament below a tiered one with a similar run
• breaks a tie between identical runs of the same tier by field strength
• does not let field strength outweigh a tier step
• latest finished season is exportable during off-season
• older seasons are not exportable during off-season
• nothing is exportable while a season is in progress

Not shown, only used by tests: tournamentRunScore, isSeasonExportableByAll