Timer Pomodoro

O temporizador Pomodoro apoia a Técnica Pomodoro, um método de gestão de tempo baseado em intervalos claros de foco e pausa. O padrão clássico é trabalhar 25 minutos, fazer uma pausa curta de cerca de 5 minutos e descansar mais após algumas rodadas. O valor não está no número exato, mas no limite que ele cria: tarefas parecem menores, distrações podem ser adiadas e pausas evitam que a atenção caia sem perceber. A ferramenta é útil para estudar, escrever, programar, tarefas domésticas, trabalho administrativo e rotinas que se beneficiam de ritmo. Em reuniões, fluxo criativo profundo ou trabalho físico, ajuste sessões e pausas com flexibilidade.

A Técnica Pomodoro foi publicada por Francesco Cirillo no final dos anos 1980 e codifica um ciclo de quatro fases: um intervalo de foco de 25 minutos (um pomodoro), uma pausa curta de 5 minutos, repetido por quatro rodadas, seguido de uma pausa longa de 15 a 30 minutos. O agendamento é uma máquina de estados finitos com quatro estados (`work`, `shortBreak`, `longBreak`, `idle`) com transições conduzidas por um único timer de contagem regressiva; o contador de rodadas é incrementado após cada transição `work -> break` e o ramo de pausa longa é acionado quando `round % roundsBeforeLong === 0`. Variantes como 50/10 (trabalho profundo) e 52/17 (estudo de produtividade do Draugiem Group) são expostas parametrizando a mesma FSM.

O timing ingênuo usa `setInterval(tick, 1000)` e decrementa um contador, mas o drift dos timers em JavaScript se acumula: cada callback pode disparar 1003-1020 ms tarde sob contenção da thread principal, e a HTML5 Page Visibility API combinada com políticas do navegador limita timers de abas ocultas para aproximadamente 1 Hz no Chrome/Firefox/Safari (Safari pode chegar a 1 disparo/min). O padrão resistente a drift armazena `endTimestamp = performance.now() + remainingMs` no início, depois recalcula `remainingMs = Math.max(0, endTimestamp - performance.now())` em cada tick — então uma aba que retoma após 10 minutos em segundo plano imediatamente compensa em vez de contar 10 segundos fictícios. `performance.now()` é o relógio monotônico de alta resolução imune a ajustes de relógio (NTP, alterações manuais de hora); `Date.now()` é usado apenas ao persistir o prazo através de atualização de página.

Quatro APIs do navegador tornam o timer utilizável enquanto o usuário trabalha em outro lugar. A Web Audio API gera o beep de fim de fase sem custo de ativos: `new AudioContext()` -> `createOscillator()` em 800 Hz -> `createGain()` com rampa descendente em 200 ms -> `start()` depois `stop(currentTime + 0.2)`. A Notifications API exibe um alerta em nível de sistema após consentimento único via `Notification.requestPermission()`, depois `new Notification('Focus complete', { body, icon, tag: 'pomodoro' })` (a `tag` deduplica disparos rápidos). A Wake Lock API solicita `navigator.wakeLock.request('screen')` para manter o display ativo durante uma sessão de foco e o libera durante as pausas. O `document.title` é reescrito a cada tick para `mm:ss - Focus` para que o tempo permaneça visível na barra de abas. Configurações (durações, início automático, som) persistem via `localStorage` (síncrono, ~5 MB de cota por origem); o progresso circular é um SVG `<circle>` cujo `stroke-dasharray = 2 * pi * r` e `stroke-dashoffset = dasharray * (1 - elapsed/total)` animam o anel sem overhead de canvas. Pesquisa sobre atenção — o limite de 25 minutos de Cirillo, mas também trabalhos sobre percepção temporal no TDAH e o custo de troca de contexto — explica por que a interrupção rígida supera um 'só mais cinco minutos' suave.

• FSM com quatro estados (work/shortBreak/longBreak/idle); pausa longa acionada quando `round % roundsBeforeLong === 0`. Padrão 25/5/15 minutos, 4 rodadas; variantes 50/10/30 (trabalho profundo) e 52/17 (estudo Draugiem).
• Timing resistente a drift: armazena `endTimestamp = performance.now() + remainingMs` e recalcula `remainingMs = endTimestamp - performance.now()` a cada tick — imune ao deslize de `setInterval` e às limitações de abas ocultas.
• `performance.now()` é o relógio monotônico de alta resolução (não afetado por NTP ou alterações manuais de relógio); `Date.now()` é usado apenas para persistir o prazo através de recarregamento de página.
• Beep de fim de fase via Web Audio API: `new AudioContext()` -> `createOscillator()` (senoide 800 Hz) -> `createGain()` com rampa linear até 0 em 200 ms -> `start()`/`stop()`. Zero ativos de áudio enviados.
• Alertas de sistema via Notifications API: `Notification.requestPermission()` uma vez, depois `new Notification(title, { body, tag: 'pomodoro' })`; a `tag` deduplica se múltiplas fases terminarem enquanto a aba está oculta.
• Screen Wake Lock API: `navigator.wakeLock.request('screen')` durante o foco para suprimir o sono do display; liberar na pausa. Wake locks são liberados automaticamente quando a aba perde visibilidade e devem ser re-adquiridos no `visibilitychange`.
• Persistência e UI: `localStorage` (~5 MB de cota) para durações/início automático/som; anel SVG usa `stroke-dasharray = 2*pi*r` e anima `stroke-dashoffset`; `document.title` reescrito para `mm:ss - Fase` para visibilidade na barra de abas.