Struct ClockReportProvider 

pub struct ClockReportProvider { /* private fields */ }

Renders a ClockReport as virtual rows above line 0 of a scan view.

Display-only, and that is the design (org-agenda.md §3): a clock report has no source range and nothing to jump to, which is exactly what VirtualRow models. The cost — you cannot put the cursor on a report line — is stated in the design rather than discovered here; making those lines actionable means excerpts over a synthetic pathless source, which is deferred.

Implementations

impl ClockReportProvider

pub fn new( view: BufferId, state: Arc<RwLock<ScanViewState>>, days: RangeInclusive<i64>, ) -> Self

Unthemed — the rows paint with the renderer’s default foreground. Test convenience; production goes through Self::with_theme.

pub fn with_theme( view: BufferId, state: Arc<RwLock<ScanViewState>>, days: RangeInclusive<i64>, theme: ThemeRegistryHandle, elements: ClockReportElementIds, ) -> Self

The production constructor: colours resolve from the registry on every collect(), and the resolved theme’s version rides in version(), so a :colorscheme swap re-paints the report instead of leaving it in the previous palette.

pub fn set_days(&self, days: RangeInclusive<i64>)

Re-point the report at a different range — what gD’s day/week/month toggles change. Bumps the version so the rows rebuild.

pub fn lines(&self) -> Vec<String>

The report as lines of text, which is what both the renderer and the tests want — splitting this out keeps the row-building testable without a theme or a worker.

Trait Implementations

impl Debug for ClockReportProvider

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl VirtualRowProvider for ClockReportProvider

fn id(&self) -> u64

A stable id for this provider. Used by the worker to deduplicate registration + route mutation notifications.

fn version(&self) -> u64

Monotonic version counter — the provider bumps it whenever the rows [Self::collect] would emit have changed. The worker uses the combined fingerprint of all providers’ versions to short-circuit on the cache-hit path without paying for the (potentially expensive) collect calls.

fn collect(&self) -> Vec<VirtualRow>

Emit the current set of virtual rows for the associated document.