kMaxFlushWaves top-level constant
Maximum number of flush waves (full drain cycles of _pending +
_dirtyFlushCallbacks) before BatchScope._flushPending aborts with a
descriptive error. Each wave corresponds to one complete pass where every
pending registry and every dirty-flush callback run; a legitimate
notification cascade needs as many waves as the longest dependency chain.
100 is far more than any real-world graph depth and keeps the total work
bounded.
Número máximo de ondas de flush (ciclos completos de drenagem de
_pending + _dirtyFlushCallbacks) antes que
BatchScope._flushPending aborte com um erro descritivo. Cada onda
corresponde a uma passagem completa em que todos os registros pendentes
e todos os callbacks de flush sujo são executados; uma cascata de
notificações legítima precisa de tantas ondas quanto a profundidade da
cadeia de dependências mais longa. 100 é muito mais do que qualquer
profundidade real de grafo e mantém o trabalho total limitado.
Implementation
const int kMaxFlushWaves = 100;