Download Latest Version openpublisher5g_amd64-windows.exe (81.1 MB)
Home / 5.7.7
Name Modified Size InfoDownloads / Week
Parent folder
5.7.7_ Canvas Scratch Area Scrolling in All Directions (Single _ Multi-Page Modes), Boundary Auto-Extension _ Floating Return Button source code.tar.gz 2026-10-12 22.5 MB
5.7.7_ Canvas Scratch Area Scrolling in All Directions (Single _ Multi-Page Modes), Boundary Auto-Extension _ Floating Return Button source code.zip 2026-10-12 22.8 MB
README.md 2026-10-12 11.6 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.7 delivers full four-directional scratch area scrolling navigation across both Single-Page and Multi-Page view modes, auto-extending boundaries, cross-browser delta normalization, and an intelligent directional return button:

  1. Four-Directional Scratch Area Scrolling (Up, Down, Left, Right): Users can freely scroll with mouse wheels or trackpads into the scratch area in all four directions in both Single-Page Mode and Multi-Page Overview. Scrolling UP or LEFT when at the edge seamlessly moves into the scratch workspace above or to the left of the page/overview grid, eliminating the hard stops previously encountered in Firefox and Chromium browsers.
  2. Multi-Page Overview Mode Parity: Scratch area scrolling, boundary auto-extensions, hand tool panning, and the floating return button now work seamlessly inside Multi-Page Mode as well as Single-Page Mode, ensuring a unified canvas experience across all view modes without requiring a return to single page mode.
  3. Seamless Directional Restoration: When scrolling back toward the document from the scratch area, the page or multi-page overview grid smoothly and intuitively restores to its base centered position before standard in-document scrolling resumes.
  4. Cross-Browser Delta Normalization: Normalizes mouse wheel and trackpad inputs across Firefox (line-based deltaMode) and Chromium (pixel-based deltaMode), ensuring identical scrolling responsiveness, speed, and tactile feel on all browsers. Also provides native Shift-wheel horizontal scroll mapping.
  5. Scratch Area Vertical Scrolling at Zooms 110% to 150%: Fixed an issue where the canvas scrollbars refused to scroll past the bottom of the page when zoomed between 110% and 150%. The editor guarantees that users can scroll at least 25% to 45% (minimum 200px) into the scratch area below the bottom of the page across all zoom levels.
  6. Scroll Boundary Auto-Extension Beyond Caps: When scrolling near or beyond the edge with the mouse wheel or trackpad, canvas scroll boundaries dynamically extend in real time, creating an expansive, flexible scratch workspace without artificial capping.
  7. Directional Floating "Return to Page" Button: If the user scrolls or pans so far into the scratch area in any direction that the document or multi-page overview is no longer in view within the viewport, a sleek floating button automatically appears in the scratch area. It features a contextual arrow indicating which direction the page is located (up, down, left, right). Clicking the button smoothly scrolls and centers the document or overview grid back into view.
  8. Panning Hand Tool Integration: Panning with the hand tool integrates seamlessly with visibility tracking and margin guide overlay synchronization, targeting the multi-page wrapper in multi-page mode and the single page paper in single-page mode.
  9. Full Subsystem Synchronization: Synchronized all 83 asset cachebusters to ?v=5.7.7 in index.html, incremented the Service Worker cache namespace to open-publisher-v5-7-7, and updated all subsystem headers and logs.

πŸ” Problems Solved & Technical Implementation

1. Halting on Scrolling Left and Up in Firefox and Chrome

  • Root Cause: In web browsers, HTML elements with overflow: auto (such as #viewport) enforce a hard lower bound where scrollTop and scrollLeft cannot be less than 0. When the viewport is at scrollTop = 0 or scrollLeft = 0, any upward or leftward wheel events (deltaY < 0 or deltaX < 0) are discarded by native browser scroll engines because the container is already at its minimum coordinate.
  • The Solution: Implemented a hybrid scroll and translation system in initCanvasScrollEnhancements() within canvas/canvas.js:
  • Dynamically targets #paper in Single-Page Mode and #multi-page-wrapper in Multi-Page Mode.
  • When vp.scrollTop <= 2 and deltaY < 0, upward wheel deltas translate the active canvas target downward via style.top, opening up visible scratch workspace above the document/overview.
  • When vp.scrollLeft <= 2 and deltaX < 0, leftward wheel deltas translate the active canvas target rightward via style.left, opening up visible scratch workspace to the left of the document/overview.
  • When reversing direction (deltaY > 0 or deltaX > 0), the active canvas target smoothly restores toward its base position before native document scrolling engages.
  • In single page mode, rulers (syncRulers) and margin guide overlays (syncMarginGuideOverlay) track the paper's exact coordinates in real time.

2. Multi-Page Overview Parity

  • Root Cause: Previously, initCanvasScrollEnhancements, checkPageVisibility, and updateCanvasScrollBounds were restricted to #paper or explicitly skipped when state.viewMode === 'multipage', disabling all scratch scrolling, boundary extensions, and return buttons whenever multi-page mode was entered.
  • The Solution:
  • Overhauled updateCanvasScrollBounds(), checkPageVisibility(), returnToPage(), and initCanvasScrollEnhancements() to detect active view mode and target #multi-page-wrapper when state.viewMode === 'multipage'.
  • Added position: relative to #multi-page-wrapper in style.css so translations function smoothly.
  • Updated the panning hand tool in extensions/system-patches.js to target #multi-page-wrapper during multi-page overview panning.
  • Ensured enterMultiPageView, refreshMultiPageZoom, and exitMultiPageView automatically recompute bounds and reset offsets cleanly when toggling between view modes.

3. Firefox Line-Delta Normalization & Shift-Wheel Mapping

  • Root Cause: Firefox emits wheel events with e.deltaMode === 1 (DOM_DELTA_LINE), producing small delta values (e.g. +/-3 lines), whereas Chromium browsers emit e.deltaMode === 0 (DOM_DELTA_PIXEL) with values around +/-100px. Unnormalized handling caused sluggish scrolling in Firefox. Furthermore, Shift-wheel combinations on Windows produced vertical deltas with the Shift modifier without populating deltaX.
  • The Solution:
  • Normalized deltaMode === 1 deltas by scaling line counts into equivalent pixel displacements.
  • Detected e.shiftKey with vertical deltas and mapped them cleanly to horizontal dx, providing universal Shift-wheel horizontal scrolling across all browsers.

4. Directional Floating "Return to Page" Button

  • Implementation: Added #floating-return-to-page-btn in index.html and styled it in style.css with smooth CSS transitions, dark mode compatibility, and hover elevation. In canvas/canvas.js, checkPageVisibility() compares the bounding box of the active canvas target with #viewport. If completely outside the viewport in any direction:
  • If page/overview is above the viewport: button shows fa-arrow-up.
  • If page/overview is below the viewport: button shows fa-arrow-down.
  • If page/overview is to the left of the viewport: button shows fa-arrow-left.
  • If page/overview is to the right of the viewport: button shows fa-arrow-right.
  • Clicking the button triggers returnToPage(), which resets custom offsets and smoothly centers the document or multi-page overview.

πŸ“ Files Modified in 5.7.7

File Changes
canvas/canvas.js Implemented full four-directional scratch area scrolling (up, down, left, right) for both Single-Page Mode and Multi-Page Mode. Overhauled updateCanvasScrollBounds(), checkPageVisibility(), returnToPage(), enterMultiPageView(), and exitMultiPageView() for view mode parity.
style.css Added position: relative to #multi-page-wrapper. Added floating pill button styling for .floating-return-btn with dark mode support. Bumped header comment to (v5.7.7).
extensions/system-patches.js Updated hand tool mousemove and mouseup listeners to target #multi-page-wrapper when in multi-page mode and #paper in single-page mode, synchronizing visibility, rulers, and margin guides.
index.html Added #floating-return-to-page-btn inside #canvas-area. Synchronized all 83 asset cachebusters to ?v=5.7.7.
sw.js Bumped Service Worker cache namespace to open-publisher-v5-7-7 and header to (v5.7.7).
extensions/ui-interactions.js Bumped About dialog version to v5.7.7.
extensions/pwa-install.js Bumped header to (v5.7.7) and Service Worker registration query to sw.js?v=5.7.7.
ui/dashboard.js Updated template fetch cachebuster queries to ?v=5.7.7.
extensions/legacy-fixes.js Bumped engine log to v5.7.7.
extensions/print-engine.js Bumped print sequence log string to v5.7.7.
ui/modals/options-modal.js Bumped header comment to (v5.7.7).
ui/sidebar-context.js Bumped header comment to (v5.7.7).
tools/proofing/spellcheck-engine.js Bumped header comment to (v5.7.7).

βœ… v5.7.7 Verification Checklist

  • [x] Scratch Area Vertical Scrolling at Zooms 110% to 150%: Verified that when zoomed at 110%, 120%, 130%, 140%, and 150%, the canvas scrollbar scrolls smoothly with at least 200px (35% to 44% of viewport height) into the scratch area below the page.
  • [x] Upward Scratch Area Scrolling (Wheel UP at Top): Verified in Chromium and Firefox across Single-Page and Multi-Page modes that scrolling up when at the top smoothly translates the canvas downward, opening visible scratch space above with synchronized coordinates.
  • [x] Leftward Scratch Area Scrolling (Wheel LEFT at Left Edge): Verified in Chromium and Firefox across Single-Page and Multi-Page modes that scrolling left when at the left boundary translates the canvas rightward, opening visible scratch space to the left.
  • [x] Smooth Restoration on Direction Reversal: Verified that scrolling down from top scratch or right from left scratch restores the paper or multi-page wrapper cleanly to base position before resuming standard document scrolling.
  • [x] Multi-Page Overview Parity: Verified that entering Multi-Page Mode supports 4-directional scratch area scrolling, boundary auto-extensions, hand tool panning, and floating return button without breaking.
  • [x] Mode Transition Reliability: Verified that switching back and forth between Multi-Page and Single-Page modes cleanly resets offsets and maintains full functionality in both modes.
  • [x] Cross-Browser Delta Normalization: Verified that Firefox line-based deltaMode and Chromium pixel-based deltaMode respond with equivalent scroll step size.
  • [x] Shift-Wheel Horizontal Navigation: Verified that Shift-wheel scrolls horizontally into left and right scratch areas.
  • [x] Directional Floating Return Button: Verified that navigating offscreen in all four directions (up, down, left, right) displays the return button with the correct directional arrow (fa-arrow-up, fa-arrow-down, fa-arrow-left, fa-arrow-right).
  • [x] Return to Page Action: Verified that clicking the return button centers the page or multi-page overview back into view, resets offsets, and hides the button.
  • [x] Hand Tool Integration: Verified that panning the page offscreen triggers the return button in both single and multi-page modes, and returning centers the canvas.
  • [x] Zero Regressions: Verified that spellcheck suppression, border art padding, and border art sliders remain 100% operational.

πŸŽ‰ Version 5.7.7 - Open Publisher

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