| Name | Modified | Size | Downloads / Week |
|---|---|---|---|
| Parent folder | |||
| 5.7.10_ Ruler Selection Span Markers _ Smooth Real-Time Cursor Position Indicators source code.tar.gz | 2026-10-13 | 22.5 MB | |
| 5.7.10_ Ruler Selection Span Markers _ Smooth Real-Time Cursor Position Indicators source code.zip | 2026-10-13 | 22.8 MB | |
| README.md | 2026-10-13 | 11.2 kB | |
| OpenPublisher-5-x86_64.AppImage | 2026-10-12 | 166.4 MB | |
| openpublisher5_amd64-windows-portable.exe | 2026-10-12 | 183.2 MB | |
| openpublisher5_amd64-windows.exe | 2026-10-12 | 165.2 MB | |
| openpublisher5_amd64-macos.dmg | 2026-10-12 | 233.1 MB | |
| openpublisher5_amd64-linux.run | 2026-10-12 | 193.4 MB | |
| openpublisher5_amd64-linux.rpm | 2026-10-12 | 215.4 MB | |
| openpublisher5_amd64-linux.flatpak | 2026-10-12 | 153.6 MB | |
| openpublisher5_amd64-linux.deb | 2026-10-12 | 156.2 MB | |
| openpublisher5_amd64-freebsd.pkg | 2026-10-12 | 185.5 MB | |
| Totals: 12 Items | 1.7 GB | 0 | |
π Summary
Version 5.7.10 upgrades the horizontal and vertical rulers so they always show where you are working on the page, and keeps that feedback glued to the mouse with zero perceptible lag:
- Selection Span Highlight: When an image, shape, text box or any other object is selected, both rulers highlight the exact span the object covers, with crisp edge lines at the start and end of the object.
- Multi-Selection Support: Selecting several objects (Ctrl/Shift click) highlights the combined bounding span of the whole group on both rulers.
- Lighter Marquee Highlight: While dragging a selection rectangle across the canvas, the rulers show the span of the marquee in a lighter, brighter tint with hairline edges, so it is clearly distinct from the stronger highlight of a committed object selection.
- Smooth Cursor Position Indicator: A thin hairline with a tiny pointer pip follows the mouse along both rulers. Tracking is now compositor-driven (transform based, zero layout reads inside mouse events) so it stays perfectly in step with the pointer instead of trailing behind it.
- Theme and Dark Mode Aware: Markers use the active UI theme colour, with brighter teal variants in dark mode for strong contrast.
- Clean Behaviour: Cursor markers hide automatically when the mouse leaves the workspace or the window loses focus, and all markers hide in Multi-Page overview where rulers are not shown.
- Complete Version & Cache Synchronization: Audited and synchronized all 83 asset query cachebusters to
?v=5.7.10inindex.html, incremented the Service Worker cache namespace toopen-publisher-v5-7-10, and updated all subsystem headers and logs. - Vertical Ruler Highlight Restored: Fixed a caching bug where the left ruler never showed the selection span (the horizontal and vertical markers shared one visibility cache key, so the vertical marker was never made visible).
- Ruler Guide Fixes: Dragging a guide back onto its ruler now deletes it instead of leaving it stuck to the paper edge. Right-clicking a ruler (for the measurement unit menu) no longer spawns a guide whose drag never ended, which caused stray guides appearing on the paper and ghost trails after switching units such as pixels.
π Root Cause Analysis & Technical Implementation
1. Why the Old Ruler Highlight Was Unreliable
- Legacy Implementation (v5.4.8): The previous highlight appended two
position: fixeddivs todocument.body, positioned them using viewport coordinates, and clamped them manually against the ruler bounds on every frame. - Limitations:
- It only looked for
.pub-element.selectedthrough a DOM query, so multi-selections (state.multiSelected) and marquee drags (state.dragMode === 'marquee') were never reflected. - Fixed positioning on
bodymeant the overlays could drift or layer above other UI during layout changes. - There was no cursor tracking of any kind.
2. Markers Now Live Inside the Rulers
initRulers()incanvas/canvas.jsinjects four marker elements directly into the rulers:#ruler-h-selection-markerand#ruler-h-cursor-markerinside#ruler-h#ruler-v-selection-markerand#ruler-v-cursor-markerinside#ruler-v- Because
#ruler-hand#ruler-valready useposition: relative; overflow: hidden;, marker coordinates are simplytargetRect.left - rulerRect.leftandtargetRect.top - rulerRect.top. Any part of an object extending beyond the visible ruler is clipped automatically, so the old manual clamping math is no longer needed. - Markers are created with inline
display: noneso they stay hidden until the tracking engine has something to show, in both Chromium and Firefox.
3. The Ruler Tracking Engine
- The legacy
installRulerHighlightsinextensions/ui-interactions.jswas replaced byinstallRulerTrackingEngine(). - Selection source priority (evaluated every animation frame):
- The live
#marquee-boxwhilestate.dragMode === 'marquee' - The bounding union of every element in
state.multiSelected state.selectedEl- Fallback query for
.pub-element.selected - Multi-Page awareness: When
.canvas-area.multi-page-canvasis active (rulers hidden) every marker is hidden. - The engine self-heals: if the rulers are rebuilt by
initRulers(), missing markers are recreated automatically.
4. Cursor Smoothness Fix (Why It Felt Behind the Mouse)
- Previous Failure Mode: The first version of the cursor tracker called
getBoundingClientRect()three times inside everymousemoveevent while the per-frame selection loop was also rewriting marker styles. That forced a synchronous layout on each event, and positioning withleft/topthen triggered another layout pass, so the hairlines landed a frame or more behind the pointer. - The Solution in 5.7.10:
- Ruler, viewport and canvas geometry is now read once per animation frame and cached. Mouse events perform no layout reads at all.
- The mouse handler stores the pointer position and moves the hairlines immediately using
transform: translate3d(...)(compositor only, no layout), withwill-change: transformandtransition: noneto guarantee instant response. - The listener is registered in the capture phase, so no other handler that stops event propagation can swallow movement updates.
- Positions are snapped to whole pixels so the 1px hairline stays crisp, and redundant style writes (display, transform, selection left/width/top/height) are skipped when values have not changed.
- The cursor is re-placed every frame against fresh geometry, so scrolling or zooming underneath a stationary mouse keeps the hairline accurate.
5. Visual Design (style.css)
- Object selection marker: Translucent theme-colour fill (24% mix of
--ui-theme-color) with 2px solid edges at the start and end of the span. - Marquee marker (
.is-marquee): A lighter 12% theme-colour fill with 1px edges tinted toward white, so a drag selection reads as light and airy rather than the same weight as a selected object. The class is added automatically while dragging and removed when the marquee ends. - Cursor marker: 1px hairline in the theme colour with a faint shadow for legibility, plus a small 3px triangular pip at the inner edge of the ruler pointing toward the canvas.
- Dark mode: Object fill
rgba(45, 212, 191, 0.28)with#2dd4bfedges; marquee fillrgba(94, 234, 212, 0.14)with palergba(153, 246, 228, 0.75)edges;#2dd4bfhairline. - Markers are
pointer-events: none, so they never interfere with ruler interactions such as creating guides or dragging indent markers.
π Files Modified in 5.7.10
| File | Changes |
|---|---|
canvas/canvas.js |
initRulers() injects the selection and cursor marker elements into #ruler-h and #ruler-v (hidden by default). |
extensions/ui-interactions.js |
Replaced installRulerHighlights with installRulerTrackingEngine() (selection, multi-selection, marquee, cached-geometry transform-based cursor tracking). Bumped header and About dialog to v5.7.10. |
style.css |
Replaced the legacy fixed-position highlight rules with ruler-relative selection markers, added the lighter .is-marquee variant, compositor-driven cursor hairline and pip styles, and dark mode overrides. |
canvas/guides.js |
Guides dropped back on their ruler are deleted (no snap-to-paper-edge), only the left mouse button creates guides, and drag state is cleared on release. |
index.html |
Synchronized all 83 asset cachebusters to ?v=5.7.10. |
sw.js |
Bumped Service Worker cache namespace to open-publisher-v5-7-10 and header to (v5.7.10). |
extensions/pwa-install.js |
Bumped header to (v5.7.10) and Service Worker registration query to sw.js?v=5.7.10. |
ui/dashboard.js |
Updated template fetch cachebuster queries to ?v=5.7.10. |
extensions/legacy-fixes.js |
Bumped engine log to v5.7.10. |
extensions/print-engine.js |
Bumped print sequence log string to v5.7.10. |
ui/modals/options-modal.js |
Bumped header comment to (v5.7.10). |
ui/sidebar-context.js |
Bumped header comment to (v5.7.10). |
tools/proofing/spellcheck-engine.js |
Bumped header comment to (v5.7.10). |
wrapper.html was not modified.
β v5.7.10 Automated Test Verification
| Test Suite | Environment | Scenario | Result |
|---|---|---|---|
| Suite 1 | Chromium & Firefox | Ruler marker elements exist in both rulers and start hidden | PASSED |
| Suite 2 | Chromium & Firefox | Mouse at (540, 380): hairlines land exactly on the pointer (H at 540px, V at 380px) | PASSED |
| Suite 3 | Chromium & Firefox | Rapid 16-step sweep across the canvas: hairline ends exactly on the final pointer position with no trailing | PASSED |
| Suite 4 | Chromium & Firefox | Mouse moved outside the workspace: both cursor markers hide | PASSED |
| Suite 5 | Chromium & Firefox | Object selected: ruler spans match the object bounds within 2px | PASSED |
| Suite 6 | Chromium & Firefox | Marquee drag: both rulers show the lighter .is-marquee tint (12% fill) |
PASSED |
| Suite 7 | Chromium & Firefox | Object deselected: both selection markers hide immediately; zero page errors | PASSED |
| Cache Audit | Static scan | All ?v= query strings in index.html, Service Worker cache name and subsystem headers reference 5.7.10 |
PASSED |
| Cross-Browser Parity | Chromium & Firefox | Executed all suites across both browser engines | 100% PASSED in both Chromium and Firefox |
β v5.7.10 Verification Checklist
- [x] Selection Span on Horizontal Ruler: Verified selecting an object highlights its exact span on the top ruler.
- [x] Selection Span on Vertical Ruler: Verified the left ruler now highlights the selected object span (shared visibility cache bug fixed).
- [x] Multi-Selection Span: Verified the combined bounding span of several selected objects is highlighted on both rulers.
- [x] Lighter Marquee Highlight: Verified a marquee drag shows a lighter, brighter tint than a committed object selection.
- [x] Smooth Cursor Tracking: Verified the cursor hairlines on both rulers stay in step with the mouse with no trailing lag.
- [x] Cursor Marker Hiding: Verified cursor markers hide when the mouse leaves the workspace or the window loses focus, and all markers hide in Multi-Page overview.
- [x] Dark Mode & Theme Colours: Verified markers follow the UI theme colour with brighter teal variants in dark mode.
- [x] Guide Removal on Ruler Drop: Verified dragging a guide back onto its ruler deletes it instead of sticking to the paper edge.
- [x] Right-Click Ruler Menu: Verified right-clicking a ruler to change units no longer spawns stray guides or ghost trails.
- [x] Cache Invalidation & SW Versioning: Verified all 83 asset queries reference
?v=5.7.10andsw.jscache name isopen-publisher-v5-7-10.
π Version 5.7.10 - Open Publisher