Theming docs don't explain that @theme inline is required for tokens to work

[gmoniava]

Page: https://ui.shadcn.com/docs/theming

The Theming page implies the token-to-utility mapping is automatic:

• "Tailwind maps these tokens into utilities like bg-background..."
• In "Token Convention", defining only --primary and --primary-foreground is said to make bg-primary resolve to var(--primary).

In Tailwind v4 that isn't true on its own. Defining --background in :root does nothing until the token is registered:

@theme inline {
  --color-background: var(--background); // now you can use utility bg-background
}

The page only shows this block in "Adding New Tokens" and the default scaffold, and never says it's required (or why it must be inline).

Suggested fix: Right after the "Tailwind maps these tokens into utilities..." sentence, add a note: "Defining a CSS variable doesn't create a utility. Register it in @theme inline as --color-* to make classes like bg-background available."