Download Latest Version openpublisher5g_amd64-windows.exe (81.1 MB)
Home / 5.7.10
Name Modified Size InfoDownloads / 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:

  1. 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.
  2. Multi-Selection Support: Selecting several objects (Ctrl/Shift click) highlights the combined bounding span of the whole group on both rulers.
  3. 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.
  4. 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.
  5. Theme and Dark Mode Aware: Markers use the active UI theme colour, with brighter teal variants in dark mode for strong contrast.
  6. 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.
  7. Complete Version & Cache Synchronization: Audited and synchronized all 83 asset query cachebusters to ?v=5.7.10 in index.html, incremented the Service Worker cache namespace to open-publisher-v5-7-10, and updated all subsystem headers and logs.
  8. 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).
  9. 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: fixed divs to document.body, positioned them using viewport coordinates, and clamped them manually against the ruler bounds on every frame.
  • Limitations:
  • It only looked for .pub-element.selected through a DOM query, so multi-selections (state.multiSelected) and marquee drags (state.dragMode === 'marquee') were never reflected.
  • Fixed positioning on body meant 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() in canvas/canvas.js injects four marker elements directly into the rulers:
  • #ruler-h-selection-marker and #ruler-h-cursor-marker inside #ruler-h
  • #ruler-v-selection-marker and #ruler-v-cursor-marker inside #ruler-v
  • Because #ruler-h and #ruler-v already use position: relative; overflow: hidden;, marker coordinates are simply targetRect.left - rulerRect.left and targetRect.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: none so they stay hidden until the tracking engine has something to show, in both Chromium and Firefox.

3. The Ruler Tracking Engine

  • The legacy installRulerHighlights in extensions/ui-interactions.js was replaced by installRulerTrackingEngine().
  • Selection source priority (evaluated every animation frame):
  • The live #marquee-box while state.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-canvas is 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 every mousemove event while the per-frame selection loop was also rewriting marker styles. That forced a synchronous layout on each event, and positioning with left / top then 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), with will-change: transform and transition: none to 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 #2dd4bf edges; marquee fill rgba(94, 234, 212, 0.14) with pale rgba(153, 246, 228, 0.75) edges; #2dd4bf hairline.
  • 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.10 and sw.js cache name is open-publisher-v5-7-10.

πŸŽ‰ Version 5.7.10 - Open Publisher

Source: README.md, updated 2026-10-13