Temporizador Pomodoro

El temporizador Pomodoro apoya la Técnica Pomodoro, un método de gestión del tiempo basado en intervalos claros de concentración y descanso. El patrón clásico es trabajar 25 minutos, hacer una pausa corta de unos 5 minutos y tomar un descanso más largo tras varias rondas. Su valor no está en el número exacto, sino en el límite que crea: las tareas parecen más pequeñas, las distracciones pueden aplazarse y las pausas evitan que la atención caiga sin notarlo. Sirve para estudiar, escribir, programar, tareas domésticas, trabajo administrativo y rutinas que ganan con ritmo. En reuniones, flujo creativo profundo o trabajo físico conviene ajustar tiempos y descansos.

La Técnica Pomodoro fue publicada por Francesco Cirillo a finales de los años 1980 y codifica un ciclo de cuatro fases: un intervalo de concentración de 25 minutos (un pomodoro), un descanso corto de 5 minutos, repetido durante cuatro rondas, y luego un descanso largo de 15-30 minutos. El temporizador es una máquina de estados finitos (FSM) con cuatro estados (`work`, `shortBreak`, `longBreak`, `idle`) cuyas transiciones están gobernadas por un único temporizador de cuenta regresiva; el contador de rondas se incrementa tras cada transición `work -> break` y la rama de descanso largo se activa cuando `round % roundsBeforeLong === 0`. Variantes como 50/10 (trabajo profundo) y 52/17 (estudio de productividad de Draugiem Group) se exponen parametrizando la misma FSM. El temporizado ingenuo usa `setInterval(tick, 1000)` y decrementa un contador, pero el desfase de los temporizadores de JavaScript se acumula: cada callback puede ejecutarse 1003-1020 ms tarde bajo contención del hilo principal, y la Page Visibility API de HTML5 combinada con las políticas del navegador limita los temporizadores de pestañas ocultas a aproximadamente 1 Hz en Chrome/Firefox/Safari (Safari puede llegar a 1 ejecución/min). El patrón resistente al desfase almacena `endTimestamp = performance.now() + remainingMs` al inicio y luego recalcula `remainingMs = Math.max(0, endTimestamp - performance.now())` en cada tick, de modo que una pestaña que se reanuda después de 10 minutos en segundo plano se actualiza inmediatamente en lugar de contar 10 segundos ficticios. `performance.now()` es el reloj monótono de alta resolución inmune a ajustes de reloj manual (NTP, cambios manuales de hora); `Date.now()` solo se usa para persistir el límite de tiempo entre recargas de página. Cuatro APIs del navegador hacen el temporizador usable mientras el usuario trabaja en otro lugar. Web Audio API genera el pitido de fin de fase sin coste de recursos: `new AudioContext()` -> `createOscillator()` a 800 Hz -> `createGain()` con rampa descendente durante 200 ms -> `start()` luego `stop(currentTime + 0.2)`. La Notifications API muestra una alerta a nivel del sistema tras el consentimiento único mediante `Notification.requestPermission()`, luego `new Notification('Focus complete', { body, icon, tag: 'pomodoro' })` (el `tag` elimina duplicados en activaciones rápidas). La Wake Lock API solicita `navigator.wakeLock.request('screen')` para mantener la pantalla encendida durante una sesión de concentración y la libera durante los descansos. El `document.title` se reescribe en cada tick a `mm:ss - Focus` para que el tiempo permanezca visible en la barra de pestañas. Los ajustes (duraciones, inicio automático, sonido) persisten mediante `localStorage` (síncrono, ~5 MB de cuota por origen); el progreso circular es un SVG `<circle>` cuyo `stroke-dasharray = 2 * pi * r` y `stroke-dashoffset = dasharray * (1 - elapsed/total)` animan el anillo sin sobrecarga de canvas. La investigación sobre atención — el límite de 25 minutos de Cirillo, pero también estudios sobre percepción del tiempo en TDAH y el coste del cambio de contexto — explica por qué la interrupción dura supera al suave 'cinco minutos más'.

• FSM con cuatro estados (work/shortBreak/longBreak/idle); el descanso largo se activa cuando `round % roundsBeforeLong === 0`. Por defecto 25/5/15 minutos, 4 rondas; variantes 50/10/30 (trabajo profundo) y 52/17 (estudio Draugiem).
• Temporizado resistente al desfase: almacena `endTimestamp = performance.now() + remainingMs` y recalcula `remainingMs = endTimestamp - performance.now()` en cada tick — inmune al deslizamiento de `setInterval` y a la limitación de pestañas ocultas.
• `performance.now()` es el reloj monótono de alta resolución (no afectado por NTP ni cambios manuales de reloj); `Date.now()` solo se usa para persistir el límite de tiempo entre recargas de página.
• Pitido de fin de fase mediante Web Audio API: `new AudioContext()` -> `createOscillator()` (senoide a 800 Hz) -> `createGain()` con rampa lineal a 0 durante 200 ms -> `start()`/`stop()`. Sin recursos de audio enviados.
• Alertas del sistema mediante Notifications API: `Notification.requestPermission()` una vez, luego `new Notification(title, { body, tag: 'pomodoro' })`; el `tag` elimina duplicados si múltiples fases terminan mientras la pestaña está oculta.
• Wake Lock API de pantalla: `navigator.wakeLock.request('screen')` durante la concentración para evitar que la pantalla entre en suspensión; se libera durante el descanso. Los bloqueos de pantalla se liberan automáticamente cuando la pestaña pierde visibilidad y deben re-adquirirse en `visibilitychange`.
• Persistencia e interfaz: `localStorage` (~5 MB de cuota) para duraciones/inicio automático/sonido; el anillo SVG usa `stroke-dasharray = 2*pi*r` y anima `stroke-dashoffset`; `document.title` se reescribe a `mm:ss - Fase` para visibilidad en la barra de pestañas.