Params · Modules

P

1 module · 11 exports · 0 repositories · 2 e2e tests · 1 route

OverviewModulesSearch params & storageE2E tests

Who imports who · hover a node

WeaponParams

app/features/params/core/WeaponParams.ts

No overview comment at the top of the file.

Imports

no other modules

Used by

1 loader3 components

Types

interface

AllVersionParams

:33

Shape of the committed all-version-*-params.json files.

export interface AllVersionParams {
	metadata: { versions: string[] };
	weapons: Record<string, Record<string, Record<string, unknown>>>;
	specialPoints?: Record<
		string,
		{ history: Array<{ version: string; value: number }> }
	>;
}

Loaders/params/:slug

Functions & values

function

parseMany

:204

Parses every given weapon id from an all-version data file, keyed by id string; ids with no data are skipped. toDataKey maps an id to the id its params are stored under (main weapons → base weapon).

export function parseMany<Id extends number>(
	ids: readonly Id[],
	data: AllVersionParams,
	toDataKey: (id: Id) => number = (id) => id,
): Record<string, ParsedWeaponParams>

Loaders/params/:slug

function

allParamKeys

:222

Every distinct ${category}.${key} across the weapons, sorted, for the comparison table rows.

export function allParamKeys(
	weaponParams: Record<string, ParsedWeaponParams>,
): ParamDefinition[]

Componentsparams/WeaponParamsTable.tsx

function

categoryWeaponIds

:257

Base main weapon ids of the weapon's category (comparison columns); a non-base weapon is kept first.

export function categoryWeaponIds(weaponId: MainWeaponId): MainWeaponId[]

Loaders/params/:slug

function

kitSiblingIds

:276

Main weapon ids sharing the base weapon (alternate kits, not alt skins), including the weapon itself.

export function kitSiblingIds(weaponId: MainWeaponId): MainWeaponId[]

Loaders/params/:slug

function

hasHistory

:286

Whether the given parameter has any tracked per-version history.

export function hasHistory(param: ParamValueWithHistory): boolean

Componentsparams/WeaponParamsTable.tsx

function

damageMultipliersForWeapon

:322

Damage multiplier history per object target, keeping the most informative row (longest history, then highest rate) when several attacks share a target. Ordered like {@link DAMAGE_RECEIVERS}.

export function damageMultipliersForWeapon(
	rows: Record<string, DamageRateHistoryRow>,
	weaponId: number,
	kind: WeaponParamKind,
): DamageMultiplierWithHistory[]

Unit tests (4)

• collects only rows applying to the weapon for the given kind
• de-duplicates identical target histories shared across rows
• merges several rows of the same target into the most informative entry
• orders entries like DAMAGE_RECEIVERS

Loaders/params/:slug

function

incomingDamageMultipliersForWeapon

:367

For a damageable sub/special: every other weapon's damage multiplier history against it, one entry per (attacker group, target) keeping the most informative. Ordered like {@link DAMAGE_RECEIVERS}.

export function incomingDamageMultipliersForWeapon(
	rows: Record<string, DamageRateHistoryRow>,
	weaponId: number,
	kind: "sub" | "special",
): IncomingDamageMultiplierWithHistory[]

Unit tests (3)

• collects other weapons' rates against the weapon's receiver targets
• de-duplicates the same attacker group and target across rows
• returns nothing for a weapon that is not a damageable object

Loaders/params/:slug

function

patchHistory

:598

Descending patch history of one weapon. Pass specialPoints for main weapons to fold those changes in.

export function patchHistory(
	parsed: ParsedWeaponParams | undefined,
	versions: string[],
	specialPoints: SpecialPointWithHistory[] = [],
	damageMultipliers: DamageMultiplierWithHistory[] = [],
	incomingDamageMultipliers: IncomingDamageMultiplierWithHistory[] = [],
): WeaponPatch[]

Loaders/params/:slug

function

kitPatchHistories

:623

Patch history per kit: shared main weapon changes + the kit's special points, sub and special. Changes are tagged by source.

export function kitPatchHistories({
	mainParsed,
	versions,
	kits,
	specialPointsByKit,
	mainDamageMultipliers,
	subParams,
	subDamageMultipliers,
	subIncomingDamageMultipliers,
	specialParams,
	specialDamageMultipliers,
	specialIncomingDamageMultipliers,
}: {
	mainParsed: ParsedWeaponParams | undefined;
	versions: string[];
	kits: WeaponKitInfo[];
	specialPointsByKit: Record<string, SpecialPointWithHistory>;
	mainDamageMultipliers: DamageMultiplierWithHistory[];
	subParams: Record<string, ParsedWeaponParams | undefined>;
	subDamageMultipliers: Record<string, DamageMultiplierWithHistory[]>;
	subIncomingDamageMultipliers: Record<
		string,
		IncomingDamageMultiplierWithHistory[]
	>;
	specialParams: Record<string, ParsedWeaponParams | undefined>;
	specialDamageMultipliers: Record<string, DamageMultiplierWithHistory[]>;
	specialIncomingDamageMultipliers: Record<
		string,
		IncomingDamageMultiplierWithHistory[]
	>;
}): KitPatchHistory[]

Unit tests (2)

• folds the kit's main, sub and special weapon changes into one descending history
• tags each change with its source and groups main before sub before special

Loaders/params/:slug

function

formatValue

:710

Formats a parameter value for display, trimming trailing zeroes from non-integer numbers.

export function formatValue(value: number | string): string

Componentsparams/ParamComparisonDialog.tsxparams/WeaponParamsTable.tsxparams/WeaponPatchHistory.tsx

Unit tests not about one export (13)

• patchHistory damage multipliers › attributes a change to the version after the recorded one and flags a higher rate as a buff
• patchHistory damage multipliers › flags a lower rate as a nerf
• patchHistory incoming damage multipliers › flags
  • a higher incoming rate as a nerf to the defending weapon and carries the attackers
  • a lower incoming rate as a buff to the defending weapon
• parse damage falloff curves › serializes a DistanceDamage array into a scaled damage @ distance string
• parse damage falloff curves › flattens nested breakpoint arrays
• parse damage falloff curves › tracks per-version history of a damage falloff curve
• classifyParamChange damage falloff curves › flags
  • higher damage as a buff
  • lower damage as a nerf
  • longer reach at the same damage as a buff
  • shorter reach at the same damage as a nerf
• classifyParamChange damage falloff curves › is
  • neutral when damage rises but reach shrinks
  • neutral when the curve gains or loses a breakpoint

Not shown, only used by tests: parse