(the specific problem found in the definition: a missing theme, a missing role, or a contrast failure with the measured ratio)

Warnings reference › variant-def:*:*

Identifier

variant-def:*:*

Raised by

The grid (rendering)

Since

1.0.1

What happened

A custom variant registration was checked and something is wrong with the definition. The consequence depends on what: a definition missing a theme or a role cannot be painted at all and is refused outright, so the token stays unknown; a complete definition that merely fails the contrast check is registered anyway, having said so, because a host may be knowingly overriding. Each distinct issue gets its own key.

The fix

Give both light and dark, each with every role, and colours that meet the contrast ratio quoted in the message.

The smallest fix

grid.variants.register('brand', { light: { fg: '#08306b', bg: '#deebf7' }, dark: { fg: '#deebf7', bg: '#08306b' } });

Reference

Covered in full at the API reference.