Add color for specific utility, undefined behaviour or not?

[yy4382]

Accroding to the docs, if i want to have a border-example which compiles to border-color: var(--example-1), I need to set a --color-example: var(--example-1) theme variable in @theme.

However I found setting --border-color-example: var(--example-1) variable also works, and only applies to border-* utilities (this is very helpful, because I can set another color for other utilities, e.g. bg-example can compile to background-color: var(example-2) if I set --bg-color-example: var(-example-2)).

I couldn't find this behaviour in the docs. The theme variable namespaces doesn't contain --border-color-* or --bg-color-*. Is this an undefined behaviour I cannnot rely on, or this is a expected behaviour but haven't been documented?

[universse]

just want to chime in. our design system currently depends on this feature. would love for it to be retained and documented. it is useful because it limits the choice of colors for each specific use case (text/background/icon/border).