Tailwind v4 dark mode: the @theme vs @theme inline gotcha that broke my contrast tests

TL;DR : in Tailwind v4 there are two ways to declare a color token in @theme . One compiles the hex value into your utility classes. The other emits a var(--...) reference that you can override from a wrapper class. Only one of these supports a multi-layer dark-mode cascade. I shipped six surfaces with invisible text because I picked the wrong one. The setup I'm running Tailwind v4 on a side project. Dark mode needs to do real work: I have always-light containers (white toast wrappers), always-d