| Name | Modified | Size | Downloads / 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:
- 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.
- 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.
- 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.
- 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.
- 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.
- 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.
- 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.
- 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.
- Full Subsystem Synchronization: Synchronized all 83 asset cachebusters to
?v=5.7.7inindex.html, incremented the Service Worker cache namespace toopen-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 wherescrollTopandscrollLeftcannot be less than 0. When the viewport is atscrollTop = 0orscrollLeft = 0, any upward or leftward wheel events (deltaY < 0ordeltaX < 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()withincanvas/canvas.js: - Dynamically targets
#paperin Single-Page Mode and#multi-page-wrapperin Multi-Page Mode. - When
vp.scrollTop <= 2anddeltaY < 0, upward wheel deltas translate the active canvas target downward viastyle.top, opening up visible scratch workspace above the document/overview. - When
vp.scrollLeft <= 2anddeltaX < 0, leftward wheel deltas translate the active canvas target rightward viastyle.left, opening up visible scratch workspace to the left of the document/overview. - When reversing direction (
deltaY > 0ordeltaX > 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, andupdateCanvasScrollBoundswere restricted to#paperor explicitly skipped whenstate.viewMode === 'multipage', disabling all scratch scrolling, boundary extensions, and return buttons whenever multi-page mode was entered. - The Solution:
- Overhauled
updateCanvasScrollBounds(),checkPageVisibility(),returnToPage(), andinitCanvasScrollEnhancements()to detect active view mode and target#multi-page-wrapperwhenstate.viewMode === 'multipage'. - Added
position: relativeto#multi-page-wrapperinstyle.cssso translations function smoothly. - Updated the panning hand tool in
extensions/system-patches.jsto target#multi-page-wrapperduring multi-page overview panning. - Ensured
enterMultiPageView,refreshMultiPageZoom, andexitMultiPageViewautomatically 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 emite.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 populatingdeltaX. - The Solution:
- Normalized
deltaMode === 1deltas by scaling line counts into equivalent pixel displacements. - Detected
e.shiftKeywith vertical deltas and mapped them cleanly to horizontaldx, providing universal Shift-wheel horizontal scrolling across all browsers.
4. Directional Floating "Return to Page" Button
- Implementation: Added
#floating-return-to-page-btninindex.htmland styled it instyle.csswith smooth CSS transitions, dark mode compatibility, and hover elevation. Incanvas/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