RFC: Add traits Field to Cards

[Aviortheking]

Summary

Add a new optional traits field to card objects. Each entry is an object with an id and a localized display string for user-facing text.

Motivation

The main goal is to support the elements from like Ultra Beast

but I'll also use this to normalize the location of the card different "traits" like EX / GX / ... (bigger list below)

Proposal

Schema:

traits?: {
  id: string;      // e.g., "gx", "ultra_beast"
  display: string; // localized label, e.g., "GX", "Ultra Beast"
}[];

Example

{
  ...
  "traits": [
    { "id": "trait_gx", "display": "GX" },
    { "id": "trait_ultra_beast", "display": "Ultra Beast" }
  ]
  ...
}

Partial Traits list

ID	Display
trait_ex	EX
trait_delta	Delta
trait_star	Star
trait_level_x	Level X
trait_sp	SP
trait_prime	Prime
trait_legende	LÉGENDE
trait_team_plasma	Team Plasma
trait_ancient_trait	Ancient Trait
trait_mega	Mega
trait_break	BREAK
trait_gx	GX
trait_ultra_beast	Ultra Beast
trait_prism_star	Prism Star
trait_v	V
trait_vmax	VMAX
trait_v_union	V-UNION
trait_vstar	VSTAR
trait_battle_style	Battle Style
trait_radiant	Radiant
trait_terastal	Terastal
trait_past	Past
trait_future	Future

Notes

• id is required and fixed; used for filtering, queries, etc.
• display is required and localized.
• Traits with no marker on card will not be inferred automatically.

Backward Compatibility

Fully backward-compatible. Field is optional.