Description

Until now, roles could only use the legacy color field, which only supports a single solid color. Discord's API exposes a colors object on roles, allowing enhanced role color configurations through primary_color, secondary_color, and tertiary_color.

This changeset introduces a dedicated RoleColors value type, exposes enhanced colors on role entities, adds support for sending and receiving the colors payload in REST and gateway models, and extends role creation/modification APIs in a way that remains backward-compatible with the existing Color API.

It also handles Discord's special tertiary color requirement: whenever tertiary_color is sent, the payload is normalized to Discord's required holographic color triplet.

Changes

• Add a new RoleColors value type to represent enhanced role colors.
• Expose enhanced role colors through IRole.Colors.
• Add RoleProperties.Colors so roles can be modified with enhanced colors.
• Keep the existing IRole.Color and RoleProperties.Color behavior for backward compatibility.
• Extend role create APIs with new CreateRoleAsync overloads that accept RoleColors.
• Update REST role models to deserialize the API colors object.
• Update modify/create role REST payloads to serialize the API colors object.
• Add conversion helpers between API models and the new RoleColors entity type.
• Update RestRole and SocketRole to surface enhanced role colors.
• Add support for enhanced role colors in role audit log data.
• Add the EnhancedRoleColors guild feature and validate it before sending enhanced color payloads.
• Allow enhanced color payloads with nullable primary_color, matching Discord's API behavior.
• Normalize any payload containing tertiary_color to Discord's required holographic values:
  • primary_color = 11127295
  • secondary_color = 16759788
  • tertiary_color = 16761760
• Preserve existing single-color behavior by continuing to populate the legacy color field when appropriate.
• Add fallback handling so roles without a colors object still expose a compatible single-color representation where possible.