I think `black` and `white` should be switched here:
color: light-dark(black, white);
color: light-dark(black, white);
Functional notation: light-dark(light-color, dark-color)
It's not declaring the relative brightness of the two colours - I agree it could be documented a little less ambiguously with something like `light-theme-color`.