Fundamentos
El tema claro es la base: cada token semántico tiene ahí su valor claro, y ningún token lleva el tema en el nombre.
Un directorio en themes/ que reproduce la estructura de semantic-tokens/ y solo redefine tokens semánticos en :root, sin selectores propios: no sabe cómo ni cuándo se carga. Junto a esos ficheros van brand/ y components/, para los tokens propios de una pieza cuyo valor depende del tema.
Cada tema se compila a su propio artefacto — ds.vadavo.dark.min.css — que ha de cargarse después de la hoja base para tomar efecto. Un tema nuevo es otro directorio y otro artefacto; la base no cambia.
Una superficie de marca hace lo mismo que un tema con el alcance de su clase en vez del de :root: redefine los tokens semánticos que cambian dentro de ella. Nada de lo que hay dentro sabe sobre qué superficie está — lee los tokens que lee siempre.
Esta documentación carga los dos y los alterna desde la barra superior, para poder ver cualquier página en uno u otro sin tocar la configuración del sistema operativo.