ranger/rangerhq-reader
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases 1 Wiki Activity

feat: mode-aware WPM ceiling — Sentence/Paragraph now go up to 3000 WPM (v1.1.1)

Browse Source 
The WPM slider's maximum value now adapts to the active reading mode:
- Word mode: 1500 WPM ceiling (human single-word recognition limit)
- Sentence / Paragraph modes: 3000 WPM ceiling

Rationale: in chunk modes, "WPM" controls auto-advance timing across
larger display units. A 20-word sentence at 3000 WPM still gets ~400 ms
of display time — well within visual-recognition comfort and suitable
for skim-pass reading of already-familiar material.

Switching back to Word mode auto-clamps the current value down to 1500
to prevent accidentally-illegible word-mode playback.

The `+` keyboard shortcut now respects the mode-specific ceiling instead
of being hardcoded to 1500.
This commit is contained in:
David Keane
2026-05-27 02:40:06 +01:00
parent 5e0ef5adf1
commit 669aabf5f2
2 changed files with 36 additions and 2 deletions
Download Patch File Download Diff File Expand all files Collapse all files
CHANGELOG.md
+19
View File
@@ -9,6 +9,25 @@ Format: [Keep a Changelog 1.1.0](https://keepachangelog.com/en/1.1.0/) — versi
---
## [1.1.1] — 2026-05-27
### Changed — Mode-aware WPM ceiling
The WPM slider's maximum value now adapts to the active reading mode:
- **Word** mode: 1500 WPM ceiling (human single-word recognition limit — beyond ~25 ms per word the brain stops registering individual words)
- **Sentence** and **Paragraph** modes: 3000 WPM ceiling. In chunk modes the "WPM" controls auto-advance timing across larger display units, so higher values still produce comprehensible reading speeds (a 20-word sentence at 3000 WPM still gets ~400 ms of display time, which is well within visual-recognition comfort)
Switching from a high-WPM chunk mode back to Word mode automatically clamps the current value down to 1500, preventing accidentally-illegible word-mode playback.
The `+` keyboard shortcut now respects the mode-specific ceiling.
### Why this matters
For skim-pass reading on long thesis papers, the previous 1500 WPM cap in Sentence mode was too conservative. With a 20-word sentence at 1500 WPM the display held each sentence for ~1 s — comfortable but slower than necessary for already-known territory. 3000 WPM cuts that to ~400 ms, suitable for the Preview / Postview phases of structured reading (preview chapters, scan for known concepts, identify sections that warrant a slower second-pass read).
---
## [1.1.0] — 2026-05-27
### Added — Sentence and Paragraph reading modes