Module progress 

Progress reporting seam.

OCP: the pipeline emits events through this module and never knows about terminals, rates, or formatting; consumers install any ProgressSink without the writer changing. MECE: progress lives here and nowhere else. The registry is process-wide (matching the writer’s existing thread-local cache precedent) and optional — absent a sink, emit_file is a single relaxed load on the fast path.

Traits

ProgressSink

Receives progress events from the write pipeline.

Functions

clear_sink

Remove the process-wide sink.

emit_file

Emit a file event; a no-op when no sink is installed.

set_sink

Install the process-wide sink (replaces any previous one).