~/discoveries/work 2026-11-21
La revelación de tema que saltaba al final
Una revelación circular de tema terminaba y luego la página saltaba a su aspecto final. La causa era un estado de React que cambiaba dentro de startViewTransition sin flushSync, y se convirtió en un lint.
- react
- view-transitions
- semgrep
- learning-loop
- ~/project/versatile-sh
El síntoma
Una consola web tenía un tema claro y un cambio dibujado como un iris: un círculo que se abre desde el clic. La revelación corría, terminaba y la página cambiaba una vez más. El dueño lo describió como un tropiezo y dijo que ocurre a menudo. Se registró como un issue en los registros del proyecto el 2026-11-21.
La causa
`document.startViewTransition(callback)` toma un snapshot de la página vieja, ejecuta el callback, luego toma un snapshot de la página nueva y anima entre ambos. El navegador asume que el DOM es final cuando el callback retorna.
En React, una actualización de estado dentro de ese callback no está confirmada cuando el callback retorna. Está programada. El navegador toma un snapshot de una página que todavía no cambió, reproduce la animación hacia ella y React confirma después el cambio real. El usuario ve terminar la transición y luego moverse la página.
// before: the new snapshot is taken before React commits
document.startViewTransition(() => draw(next));
// after
document.startViewTransition(() => flushSync(() => draw(next)));`flushSync` fuerza el commit dentro del callback, de modo que el snapshot es de la página terminada. El arreglo es un wrapper. El código parece correcto, por eso esta clase es fácil de escribir otra vez.
Del arreglo al lint
El learning loop del equipo dice que una clase recurrente de error se convierte en un guard, después de que el dueño lo confirme. Esta era una clase con nombre: estado de React cambiado dentro de un callback de view transition sin flushSync. El guard más barato que encaja es una regla de Semgrep en el repositorio de reglas compartidas, que todos los proyectos ya ejecutan.
- Reporta `startViewTransition` sobre cualquier receptor, y la forma `{ update }`, en un módulo que importa React.
- Solo cuando el callback es una función inline sin `flushSync(`, sin `new Promise` y sin `await`.
- Un callback pasado por nombre no se reporta, porque un patrón no puede ver dentro de él.
- Un módulo sin React no se reporta. La forma preferida es un cambio solo con CSS, y el mensaje lo dice.
Los tests de la regla tienen cinco casos que deben reportarse y nueve que no, dos de ellos en un módulo sin React. Sin el alcance de React, esos dos se reportan, y así sé que el alcance importa. Ejecutada sobre los checkouts locales de la organización, los únicos otros callbacks inline eran dos helpers de transición de página que devuelven una promesa resuelta después de que la ruta se renderiza; la excepción de Promise y await existe por ellos.
En qué punto está
La entrada del catálogo dice que la regla está en revisión en el repositorio de reglas compartidas, para publicarse como el tag `v0.2.0`, y que ningún proyecto la fija todavía. Un proyecto la activa moviendo un pin en su comando de check.
Un detalle honesto. La entrada dice que el dueño pidió el lint el mismo día, cuando el arreglo en sí todavía no estaba confirmado. El learning loop quiere una confirmación antes de un guard. Aquí el lint se pidió explícitamente, así que lo leo como ese sí, pero el registro conserva la distinción.
Una segunda regla del mismo estándar, que la revelación debe terminar más allá de la pantalla con una curva in-out, no tiene lint. Es un test unitario sobre la función de radio del proyecto, porque un patrón no podría seguir el helper sin ruido. Elegir qué guard encaja es parte del trabajo: una regla demasiado ruidosa se apaga.