@cogita/plugin-reading-progress provides article reading support:
The plugin does not add third-party analytics or modify Markdown files. Position memory is off by default and, when enabled, writes only to the current browser's localStorage.
enabled: when off, the plugin still provides an empty runtime module; the theme skips the enhancement UI without a build failure.showBar: controls the fixed article-top progress bar.showReadingTime: controls the estimated reading time and live percentage.showTocProgress: highlights the current heading and sets aria-current="location".rememberPosition: restores the scroll position by article route; off by default.wordsPerMinute: the reading unit per minute; Chinese is estimated by characters and English by words.includeCode: includes fenced code blocks in the estimate when enabled.Core supplies defaults so the default theme can safely consume the virtual module. A custom theme can disable the plugin explicitly. When disabled, the plugin does not scan posts and emits empty statistics plus a closed state, preserving both opt-out behavior and safe static imports.
The plugin scans Markdown and MDX files under posts.dir and produces:
It removes frontmatter, link URLs, HTML tags, heading markers, and code blocks unless includeCode is enabled. The result is at least one minute so short posts never display zero minutes.
virtual-reading-progress-data exposes:
readingProgressConfig;readingStatsByRoute;getReadingStats(route).The module contains only runtime data. It does not expose local absolute paths or article bodies.
Lucid's global UI reads the statistics for the current article URL:
aria-current="location";For the Chinese version, see 阅读进度插件设计.