Skip to main content

FUI2014: Theme-coupled literal should use a semantic token

moderate

Why Fragments emitted FUI2014 and how to resolve theme/no-theme-coupled-literal.

Details

diagnostic
{
  "code": "FUI2014",
  "ruleId": "theme/no-theme-coupled-literal",
  "category": "Tokens",
  "defaultSeverity": "moderate",
  "lifecycle": "experimental",
  "fixAvailable": false,
  "evidenceRequired": true
}

Guidance

## What it means

Fragments emitted `FUI2014` from `theme/no-theme-coupled-literal` because the scanned source conflicts with an active tokens contract rule. The finding location and evidence identify the exact authored input that was evaluated.

## How to resolve it

Review the finding evidence, then change the source or the documented check so `theme/no-theme-coupled-literal` reflects the intended contract. Do not hide the finding with a broad repository exclude. When an exception is intentional, use a line-attached, reasoned directive from the [exceptions reference](/cloud/verdicts#in-source).

## Verify the change

Run `npx @usefragments/cli check --changed --format agent`, inspect the resulting evidence, and then run `npx @usefragments/cli check --changed --ci`. If the finding changes identity, review baseline churn instead of silently regenerating the baseline.

Intentional exception? Use a narrow, reasoned directive from the in-source exception reference.

Next steps

  • RulesThe rules that emit FUI codes.
  • ExceptionsIn-source allows and Cloud exceptions.