Scoping with [background,border,...]-color-* theme variables

[VincentCordobes]

In Tailwind 4, the doc mentions that defining a theme variable like --color-my-blue generates utility classes such as bg-my-blue and text-my-blue.

I noticed we can "scope" colors by prefixing them. For example, the following code generates utility classes like bg-button and border-input, but not bg-input nor border-button, as one might expect.

@theme inline {
  --background-color-button: ...;
  --border-color-input: ...;
}

I'm happy to see it works that way, however, I couldn't find anything about this in the doc. It only mentions the --color-* namespace.

Is this an intended and supported way to define theme variables?

[VincentCordobes]

Just noticed the question was asked here #16111

Maybe it would be worth mentioning this behavior in the documentation ? cc @philipp-spiess