| Name | Modified | Size | Downloads / Week |
|---|---|---|---|
| Parent folder | |||
| 5.3.5_ Ignore Theme Toggle _ Master Theme Restoration Engine source code.tar.gz | 2026-10-06 | 22.4 MB | |
| 5.3.5_ Ignore Theme Toggle _ Master Theme Restoration Engine source code.zip | 2026-10-06 | 22.7 MB | |
| README.md | 2026-10-06 | 11.3 kB | |
| OpenPublisher-5-x86_64.AppImage | 2026-10-06 | 166.4 MB | |
| openpublisher5_amd64-windows-portable.exe | 2026-10-06 | 183.2 MB | |
| openpublisher5_amd64-windows.exe | 2026-10-06 | 165.2 MB | |
| openpublisher5_amd64-macos.dmg | 2026-10-06 | 233.1 MB | |
| openpublisher5_amd64-linux.run | 2026-10-06 | 193.4 MB | |
| openpublisher5_amd64-linux.rpm | 2026-10-06 | 215.4 MB | |
| openpublisher5_amd64-linux.flatpak | 2026-10-06 | 153.6 MB | |
| openpublisher5_amd64-linux.deb | 2026-10-06 | 156.2 MB | |
| openpublisher5_amd64-freebsd.pkg | 2026-10-06 | 185.5 MB | |
| Totals: 12 Items | 1.7 GB | 0 | |
🚀 Summary
Version 5.3.5 delivers a dedicated usability overhaul to the Page Design ribbon tab and Theme Studio Engine, converting the one-way "Ignore Theme" action into a fully reactive, bidirectional toggle button with real-time visual feedback, automatic theme de-selection resets, instantaneous master theme restoration, and per-page synchronization across multi-page documents.
In earlier versions, invoking "Ignore Theme" was an irreversible one-way operation. Once clicked, the current page was permanently flagged with ignoreBackground = true, preventing users from ever setting or changing a theme again on that page. Any subsequent attempt to select a gradient, texture, or palette swatch was instantly purged by the self-healing background engine within 500ms.
With this release, "Ignore Theme" functions as a true bidirectional toggle: clicking it overrides the master theme with a blank canvas and highlights the button with active ribbon styling. Clicking it a second time turns the override off and immediately restores the document master theme. Furthermore, selecting any theme or color swatch automatically clears the ignore override, disengages the active button state, and applies the selected theme without ribbon tab disruption or data loss.
🔍 Context & Problem Analysis
An exhaustive audit of user feedback identified three major friction points with the Page Design ribbon tab:
- Irreversible One-Way Lockout:
- The legacy
clearPageBackground()routine inui/themes.jspermanently assignedignoreBackground = trueto the active page without providing any toggling mechanism to disengage it. -
Once a user tested or used "Ignore Theme", there was no user-facing way to un-ignore themes on that page.
-
Self-Healing Watchdog Purged New Themes:
- The theme watchdog loop in
extensions/legacy-fixes.jscheckedif (state.pages[state.currentPageIndex]?.ignoreBackground) theme.remove();. -
Because
applyThemeToCanvasdid not clear theignoreBackgroundflag when swatches were clicked, the watchdog immediately removed any newly applied theme from the canvas, giving the illusion that the theme picker was broken. -
Absence of Visual Toggle Feedback:
- The
#no-bg-btnribbon button remained visually inert regardless of whether the page was ignoring themes or displaying one. -
Users had no visual cues indicating why themes were not applying or which pages had overrides enabled.
-
Ribbon Tab Jump During Theme Restoration:
- Rebuilding theme DOM wrappers routed through
createWrapper(), which selected the new element and jumped the active ribbon tab away fromPage Designto contextual formatting tabs.
🛠️ Architectural Solution & Implementation
1. Bidirectional toggleIgnoreTheme() in ui/themes.js
- Re-architected
clearPageBackground()intowindow.toggleIgnoreTheme(), maintainingwindow.clearPageBackgroundas an alias for complete backward compatibility. - Seamlessly flips
curPage.ignoreBackground = !curPage.ignoreBackground: - When Toggled ON: Caches any existing background color (
curPage._previousBg), clears existing theme DOM elements, sets paper background to clean#ffffff, and updates ribbon button styling. - When Toggled OFF: Restores the document's saved master theme immediately via
window.restoreThemeFromSave(), or recovers the cached background color.
2. Reactive Toggle Button Styling & Accessibility (#no-bg-btn)
- Created
window.updateIgnoreThemeButtonUI()to synchronize the DOM button state withstate.pages[state.currentPageIndex]?.ignoreBackground. - Integrated native Office ribbon active toggle styling in
style.css: - Applies
.activeclass withcolor-mix(in srgb, var(--ui-theme-color) 20%, transparent)background tint and1.5px solid var(--ui-theme-color)accent border. - Updates
aria-pressed="true"when enabled and"false"when disabled. - Sets intuitive tooltips:
"Theme Ignored on this page (Click to re-enable themes)"vs"Ignore Theme (Blank Page)".
3. Smart Auto-Reset upon Theme Selection
- Updated
applyThemeToCanvasinextensions/legacy-fixes.jsto automatically setcurPage.ignoreBackground = falseand invokeupdateIgnoreThemeButtonUI()whenever a user clicks any Theme Studio gradient or texture swatch. - Updated color palette swatch clicks in
ui/themes.jsto clearignoreBackgroundand update the toggle button state. - Completely prevents the background self-healer from discarding newly chosen themes.
4. Non-Destructive Theme Reconstruction (restoreThemeFromSave)
- Extracted theme restoration logic from the background interval into a reusable
window.restoreThemeFromSave()engine. - Added active ribbon tab preservation (
activeTabId) and temporarywindow.switchTabmuting during wrapper instantiation. - Eliminates ribbon tab jumps, keeping the user smoothly anchored on the
Page Designtab.
5. Multi-Page Synchronization & History Serialization
- Hooked
window.updateIgnoreThemeButtonUI()directly intorenderPage()incore/pages.js. - Navigating between pages via thumbnails, page counter, or keyboard shortcuts dynamically updates
#no-bg-btnto reflect the active page's specific override state. - Preserved full state serialization in
core/history.js(ignoreBackground: existingPage.ignoreBackground || false), ensuring undo/redo actions accurately update the toggle button and canvas.
🛠️ Files Modified
- ui/themes.js: Replaced one-way background clearing with
window.toggleIgnoreTheme(), addedwindow.updateIgnoreThemeButtonUI(), updated color swatch clicks to auto-reset ignore state, and maintainedwindow.clearPageBackgroundalias. - extensions/legacy-fixes.js: Bound
#no-bg-btntotoggleIgnoreTheme(), configuredapplyThemeToCanvasto resetignoreBackground = false, extractedwindow.restoreThemeFromSave(), and added active tab preservation during element creation. - core/pages.js: Integrated
window.updateIgnoreThemeButtonUI()intorenderPage()to synchronize ribbon toggle state on page switch and document deserialization. - style.css: Added native ribbon
.activestyling for#no-bg-btnwith theme color mix, inset shadow, scaled icon, and high-contrast hover states. - index.html: Bumped all script, stylesheet, and asset cachebusters from
?v=5.3.4to?v=5.3.5. - sw.js: Updated Service Worker cache name to
open-publisher-v5-3-5and version headers. - extensions/pwa-install.js: Bumped version header and SW registration to
sw.js?v=5.3.5. - extensions/geo-defense.js: Bumped version header to
(v5.3.5). - ui/dashboard.js: Bumped template index and file fetch queries to
?v=5.3.5. - elements/templates/templates.js: Bumped template index queries to
?v=5.3.5. - elements/arrow/arrow.js: Bumped version comments to
v5.3.5.
🧪 Verification & Automated Testing
All features and interactions were validated through an automated Playwright end-to-end test suite:
| Test Scenario | Verification Metric | Result | Output Details |
|---|---|---|---|
| Initial Page State | #no-bg-btn inactive state and page flag |
Passed | Class contains no .active; state.pages[0].ignoreBackground is falsy |
| Theme Studio Selection | Applying gradient swatch from Theme Studio | Passed | Theme container rendered inside paper; #no-bg-btn remains inactive |
| Ignore Theme Toggle ON | Clicking #no-bg-btn to engage override |
Passed | Button gains .active class; ignoreBackground set to true; theme removed from canvas |
| Ignore Theme Toggle OFF | Clicking #no-bg-btn to disengage override |
Passed | Button loses .active class; ignoreBackground set to false; theme instantly restored |
| Auto-Reset on New Theme | Selecting second theme while ignore is active | Passed | Button resets to inactive; new gradient applied and persists without watchdog deletion |
| Multi-Page Synchronization | Switching between Page 1 (theme) and Page 2 (ignored) | Passed | Page 1 button is inactive; Page 2 button is active; state accurately tracks page changes |
| Ribbon Tab Preservation | Applying themes does not switch ribbon tabs | Passed | Active tab remains Page Design; no unwanted jumping to Format or Home tabs |
| Visual Artifact Generation | Verified screenshot capture and inspection | Passed | Saved verified visual screenshots in artifacts directory |
✅ Checklist Completed
- [x] Converted Ignore Theme to a Bidirectional Toggle: Replaced one-way flag assignment with
window.toggleIgnoreTheme(), allowing users to turn the theme override on and off at will. - [x] Added Native Ribbon Active Styling: Designed responsive
.activetoggle state instyle.cssfeaturing themed accent background tints, high-contrast borders, and interactive hover feedback. - [x] Implemented Instant Master Theme Restoration: Created
window.restoreThemeFromSave()to immediately reconstruct document themes when the override is toggled off. - [x] Fixed Theme Selection Blocking: Updated
applyThemeToCanvasand color palette swatches to automatically clearignoreBackgroundand deactivate the toggle button upon selecting a theme. - [x] Eliminated Ribbon Tab Jumping: Preserved the active tab identifier during theme wrapper instantiation, keeping the user anchored on the Page Design tab.
- [x] Integrated Per-Page Synchronization: Hooked button state updates into
renderPage(), ensuring the toggle button accurately reflects the active page across navigation. - [x] Preserved Undo and Redo History: Ensured
ignoreBackgroundis cleanly serialized incore/history.jsand restored on state navigation. - [x] Full Version 5.3.5 Synchronization: Updated Service Worker cache (
open-publisher-v5-3-5), PWA installer, module headers, template fetchers, and all 79 cachebusters inindex.html. - [x] 100% Automated Verification Pass Rate: Executed comprehensive Playwright end-to-end tests validating all toggle transitions, swatch selections, and multi-page workflows.
- [x] Strict Adherence to Project Rules: Stored notes strictly in the artifacts directory; strictly zero em dashes used; no remote git push.
🎉 Version 5.3.5 - Open Publisher