svelte-kit-vice/docs/process/CONTINUE-theming.md

CONTINUE — eje Theming «theme-reach» (handoff, act. 2026-08-19)

Estado: PLAN ENTREGADO, NADA FIRMADO, NADA CONSTRUIDO (salvo el instrumento de medida, scripts/theming-census.ts, que no es un guard).

La fuente viva es el plan: PLAN-theming.md. Este fichero sólo dice por dónde entrar y qué NO hacer.

Por dónde entrar

1. Leer PLAN-theming.md entero (§0 veredicto · §1 censo · §2–§3 contratos objetivo · §4 decisiones · §5 fases · §7 protocolo). No a medias.
2. Comprobar §4: si D-TH.1…D-TH.8 no están firmadas, presentarlas una por mensaje con las cinco preguntas del autor y PARAR. No arrancar F0 sin D-TH.1, D-TH.2 y D-TH.5 al menos.
3. Si están firmadas: F0 (instrumento + R-5 en warn + test del suelo) → F1 (doctrina + codemod de nombres si D-TH.6) → F2 por bloques, un componente = un commit, cada uno con el protocolo de §7 ENTERO y sus artefactos en el mensaje de commit.

Reproducir la cifra antes de creerla

node --import tsx/esm scripts/theming-census.ts

Debe dar 162 recetas · 5.205 knobs · 1.621 públicos (33 %) · 62 sin contrato (2026-08-19). Si la cifra no cuadra, alguien tocó recetas desde entonces: regenerar §9 del plan con --json antes de seguir.

Lo que costó cuatro commits en un día (no repetirlo)

• Medir el nodo que el usuario señala, no el que el código toca: el «cuadrado» del hover del nav era el velo sobre el <li> (archetype: 'item'), no el trigger; cuatro sondas de getComputedStyle sobre el trigger lo dieron por arreglado. Desde el píxel hacia arriba (elementsFromPoint) y captura 2×.
• El hover es DEL SISTEMA: la capa de archetypes.css en el nodo con forma. Ni un background: a mano, ni background-image: none, ni una escalera de color por componente. «¿De dónde sacas esos estilos?» — de ningún sitio.
• El default no cambia en este eje. Un default que parezca defecto se anota y se firma aparte (D-TH.5).
• Doble animación al mover un sello de sema a una superficie con entrada propia: registro de animationstart/end, y la doctrina de motion.md decide quién posee el eje (la firma en la aparición; el movimiento coordinado en el swap).
• Pantalla oculta = rAF congelado; sondas con Playwright headless desde la RAÍZ del repo. .ts profundos en caché de disco: sólo Ctrl+Shift+R.
• Rama compartida: nunca git stash para medir una base; check se compara POR FICHERO; git add con rutas explícitas; git commit -F; nunca --amend. Otra sesión puede llevarse tus hunks en SU commit si tocáis el mismo fichero: avisarlo, no rehacerlo.

Fuentes

• Plan y decisiones: PLAN-theming.md.
• Precedente ejecutado de la forma: PLAN-sidebar.md §3 + F3; navigation-menu (ae9e277fa · 822b78cf2 · a82794845).
• Doctrina: docs/theming/reference.md §6/§7/§12/§16 · docs/canon/recipe-contract.md · docs/canon/tsc.md · docs/theming/motion.md.