Download Latest Version openpublisher5g_amd64-windows.exe (81.1 MB)
Home / 5.4.6
Name Modified Size InfoDownloads / Week
Parent folder
OpenPublisher-5-x86_64.AppImage 2026-10-07 166.4 MB
openpublisher5_amd64-windows-portable.exe 2026-10-07 183.2 MB
openpublisher5_amd64-windows.exe 2026-10-07 165.2 MB
openpublisher5_amd64-macos.dmg 2026-10-07 233.1 MB
openpublisher5_amd64-linux.run 2026-10-07 193.4 MB
openpublisher5_amd64-linux.rpm 2026-10-07 215.4 MB
openpublisher5_amd64-linux.flatpak 2026-10-07 153.6 MB
openpublisher5_amd64-linux.deb 2026-10-07 156.2 MB
openpublisher5_amd64-freebsd.pkg 2026-10-07 185.5 MB
5.4.6_ High-Performance Visual Spell Check Engine _ Status Bar Auto-Revert source code.tar.gz 2026-10-07 22.5 MB
5.4.6_ High-Performance Visual Spell Check Engine _ Status Bar Auto-Revert source code.zip 2026-10-07 22.7 MB
README.md 2026-10-07 23.1 kB
Totals: 12 Items   1.7 GB 0

πŸš€ Summary

Version 5.4.6 of Open Publisher introduces a dedicated, high-performance Visual Spell Check Engine using the modern W3C CSS Custom Highlight API (::highlight(spelling-error)) seamlessly integrated with Open Publisher's existing online spell check service (LanguageTool). This ensures that misspelled words in canvas text boxes reliably display crisp, high-visibility red wavy squiggly underlines across all zoom scales (including the default 60% view), whether actively typing, selecting text elements, or right-clicking to inspect context suggestions. By integrating directly with the existing online spell checker and maintaining an intelligent client-side session cache, the engine requires zero bundled dictionary files, keeping the application ultralight and nimble.

In addition, this release guarantees that red wavy squiggly underlines remain completely solid and continuous under the entire word by disabling ink skipping (text-decoration-skip-ink: none). Previously, letters with descenders (such as y, g, p, q, j) caused the browser's default skip-ink algorithm to punch gaps in the underline, fragmenting it into disconnected chunks. With this fix, wavy lines stretch uninterrupted from the first character to the last. Furthermore, this release adds "Add to Dictionary" and "Ignore All" options directly to the right-click context menu, and resolves the lingering status message issue by adding an automatic 2.5-second revert timer and keystroke clearing listener to the status bar.

Prior to this release, misspelled words inside text boxes failed to display red squiggly underlines. While Open Publisher's right-click context menu successfully retrieved spelling corrections from LanguageTool, the actual visual wavy red underlines were completely absent on the canvas. Investigation revealed that Chromium-based browsers (Chrome, Microsoft Edge) suppress native ::spelling-error text decorations on elements inside CSS transformed containers (transform: scale(...)). Because Open Publisher scales #paper via CSS transforms to support canvas zoom (defaulting to 60%), Chromium rendered zero native squiggly pixels regardless of text zoom or subpixel line thickness. Furthermore, native browser spellcheck underlines are automatically dismissed by the browser whenever an element loses active text cursor focus (such as when selecting an element or opening the right-click context menu). Separately, when a user dragged or copied highlighted text chunks using the v5.4.5 text drag engine, the bottom-left status bar message #status-msg remained stuck displaying "Text Moved" or "Text Copied" indefinitely until explicit deselection.

In v5.4.6, visual proofing and status feedback are fully restored and modernized:

  • Scale-Invariant Visual Spell Check Engine: Powered by the W3C CSS Custom Highlight API, rendering crisp GPU-accelerated wavy red underlines under misspelled words across any zoom level (60%, 75%, 100%, 150%, 200%).
  • Unbroken Continuous Underline Coverage (text-decoration-skip-ink: none): Prevents characters with descenders (y, g, p, q, j) from punching holes in the wavy line, ensuring smooth, uninterrupted squiggly underlines that cover the full length of each misspelled word.
  • Non-Destructive Range Highlighting: Misspelled words are marked using native browser Range objects without modifying innerHTML, without inserting wrapper <span> tags, without disrupting caret positioning, and without polluting history undo/redo (pushHistory).
  • Online Spell Check Integration with Smart Caching: Fully leverages Open Publisher's existing LanguageTool online spell check service. Misspellings are verified in batches and cached in memory, eliminating redundant network calls while completely avoiding the overhead of bundling offline dictionary files.
  • Persistent Visibility During Element Selection and Context Menu Open: Red wavy squigglies remain visibly rendered beneath misspelled words when a text box is selected as an object and when right-clicking to view suggestions.
  • Context Menu "Add to Dictionary" and "Ignore All": Users can right-click any misspelled word to add it to their personal dictionary (persisted in localStorage) or ignore it for the session, instantly clearing the squiggly line.
  • Instant Cached Suggestions: If spelling suggestions have already been retrieved during background verification, the right-click context menu displays them instantly with zero network delay.
  • Accurate Misspelling Filtering: Online check results are filtered to target spelling errors specifically, preventing false positives on capitalized words or typography.
  • LanguageTool Suggestion Synchronization: Applying a spelling suggestion from the context menu immediately updates document text, commits history, and re-scans the text box to refresh underlines in real time.
  • Global Spell Check Toggle Synchronization: Toggling "Spelling" in the ribbon or "Check spelling as you type" in the Options dialog immediately clears or restores all wavy squigglies across the document.
  • Status Bar Auto-Revert (2.5s): The status bar message automatically reverts from "Text Moved" or "Text Copied" back to "Element Selected" or "Ready" after 2.5 seconds.
  • Keystroke Status Bar Reset: If the user immediately starts typing after moving or copying text, the status bar clears the move message instantly.
  • Print and Export Protection: Dedicated @media print CSS rules guarantee that red squiggly underlines never appear on exported PDFs or physical prints.

All cachebusters across index.html, the Service Worker cache (open-publisher-v5-4-6), and subsystem headers have been synchronized to v5.4.6.


πŸ” Problems Solved & Key Enhancements

  1. Chromium Transform Suppression of Native Spellcheck Underlines:
  2. Problem: In Chromium and Microsoft Edge, native browser ::spelling-error text decorations are suppressed on elements inside CSS transformed containers (transform: scale(...)). Because Open Publisher's canvas (#paper) uses CSS transforms to support arbitrary zoom levels (defaulting to 60% zoom), the browser painted zero native red squiggly pixels at any zoom level.
  3. Solution in v5.4.6: Built a dedicated client-side visual highlighting engine in tools/proofing/spellcheck-engine.js using the standard W3C CSS Custom Highlight API (::highlight(spelling-error)). This paints hardware-accelerated wavy underlines directly through the browser compositor regardless of parent CSS transforms or zoom levels.

  4. Fragmented Squiggly Underlines on Words with Descenders:

  5. Problem: By default, browsers apply text-decoration-skip-ink: auto, which interrupts underlines whenever a character descender crosses below the baseline. For words containing descenders such as y, g, p, q, or j (for example, words like kygyugl, ggy, uyfg, or suppoii), the wavy line was severed into small disjointed fragments and disconnected dots.
  6. Solution in v5.4.6: Explicitly declared text-decoration-skip-ink: none !important; on ::highlight(spelling-error), ::spelling-error, and editable text elements. This ensures underlines flow continuously beneath the entire word without breaks.

  7. Spellcheck Disappearance on Element Selection & Context Menu Blur:

  8. Problem: Native browser spellcheck underlines are designed to disappear as soon as an editable element loses active text cursor focus. When users selected a text box to inspect it, resize it, or right-clicked on a misspelled word to view corrections, native underlines vanished completely.
  9. Solution in v5.4.6: Range-based CSS highlights remain active and rendered whether the text box is currently focused, selected as an element, or blurred with the right-click context menu open.

  10. No Bloat: Pure Online Spell Check Integration Without Bundled Dictionaries:

  11. Problem: Bundling an entire offline dictionary file inflates package size, adds hundreds of kilobytes of static assets, and duplicates existing online proofing capabilities.
  12. Solution in v5.4.6: No offline dictionary files are bundled. The visual highlight engine queries Open Publisher's existing LanguageTool API in lightweight batches (up to 50 unverified words) with client-side caching (_knownGoodWords and _knownBadWords). Verified words are remembered, ensuring near-instantaneous subsequent checks without repeated network calls or bundled file overhead.

  13. False Positive Prevention on Sentence Starters:

  14. Problem: Batching words for online checks can trigger grammar and capitalization rules (such as UPPERCASE_SENTENCE_START or CASING), which would mistakenly flag correct capitalized words like "This" or "Apple" as spelling errors.
  15. Solution in v5.4.6: The engine filters API match results specifically for spelling issues (issueType === 'misspelling' or category TYPOS), ensuring capitalization and typography rules never produce false squiggly underlines.

  16. Context Menu Proofing Actions (Add to Dictionary & Ignore All):

  17. Problem: When right-clicking a misspelled word, users could only view suggestions; there was no way to teach the editor custom names, technical terms, or brand words.
  18. Solution in v5.4.6: Added "Add to Dictionary" (persisted to localStorage.getItem('opub_custom_dictionary')) and "Ignore All" directly below spelling suggestions in ui/menus.js. Selecting either option instantly removes the red squiggly underline.

  19. Status Bar Message Stuck on "Text Moved" / "Text Copied":

  20. Problem: Moving or copying highlighted text via the v5.4.5 text drag engine updated #status-msg to "Text Moved" or "Text Copied", but lacked an auto-revert timer or typing listener, leaving the message stuck permanently until element deselection.
  21. Solution in v5.4.6: Added a 2.5-second timeout in canvas/text-drag.js that restores "Element Selected" (or "Ready"), along with an input event listener that immediately clears the message when typing resumes.

πŸ› οΈ Complete Architectural Breakdown

1. Visual Highlight Engine (tools/proofing/spellcheck-engine.js)

  • Range Scanning (paintHighlights()): Queries all editable containers inside #paper (.pub-element [contenteditable="true"]). Uses document.createTreeWalker(editable, NodeFilter.SHOW_TEXT) to iterate through text nodes and extract word tokens using regex /[A-Za-z]+(?:['’][A-Za-z]+)?/g.
  • Word Validation (isWordMisspelled(word)):
  • Respects global state: if state.spellCheck === false, immediately returns false.
  • Normalizes tokens: strips surrounding punctuation, skips numbers/digits, single-character tokens, and 2-5 letter uppercase acronyms (PDF, PNG, SVG).
  • Checks custom dictionary Set (_customDictSet) and session ignored words Set (_ignoredSet).
  • Checks in-memory cache: if present in _knownGoodWords, returns false; if in _knownBadWords, returns true.
  • Batch Verification (checkWithOnlineService(wordsToCheck)):
  • Batches unverified words up to 50 at a time and queries LanguageTool (https://api.languagetool.org/v2/check).
  • Strictly filters matches for spelling errors (m.rule.issueType === 'misspelling' or m.rule.category.id === 'TYPOS').
  • Unflagged words in the batch are added to _knownGoodWords.
  • Flagged words are stored in _knownBadWords and their suggestions are cached in _suggestionsMap.
  • Highlight Registration: For each misspelled word, constructs a DOM Range bounded by the text node and character offsets. Bundles all ranges into new Highlight(...ranges) and registers them with CSS.highlights.set('spelling-error', highlight).
  • Non-Destructive Operation: Does not touch innerHTML, does not insert spans or formatting wrappers, does not shift caret positions, and does not push history transactions.

2. High-Visibility Continuous Styling & Print Concealment (style.css)

:::css
/* Modern Chromium / Edge Spellcheck Rendering Fix under Canvas Transform (v5.4.6) */
::highlight(spelling-error) {
    text-decoration: underline wavy #e74c3c !important;
    text-decoration-skip-ink: none !important;
    text-decoration-thickness: 2px !important;
    text-underline-offset: 3px !important;
}
@media print {
    ::highlight(spelling-error) {
        text-decoration: none !important;
    }
}
[contenteditable="true"],
.element-content,
.element-content [contenteditable="true"] {
    text-decoration-skip-ink: none !important;
}
::spelling-error {
    text-decoration: underline wavy #e74c3c !important;
    text-decoration-skip-ink: none !important;
    text-decoration-thickness: 2px !important;
    text-underline-offset: 3px !important;
}
[contenteditable="true"]::spelling-error,
.element-content [contenteditable="true"]::spelling-error {
    text-decoration: underline wavy #e74c3c !important;
    text-decoration-skip-ink: none !important;
    text-decoration-thickness: 2px !important;
    text-underline-offset: 3px !important;
}
[spellcheck="false"]::spelling-error,
[contenteditable="true"][spellcheck="false"]::spelling-error {
    text-decoration: none !important;
}

3. Context Menu Proofing Integration (ui/menus.js & ui/ui.js)

  • Instant Cached Suggestions: In ContextMenuSystem.handleRightClick, checks SpellCheckEngine.getSuggestions(cleanWord) first. If cached suggestions exist, renders them instantly.
  • Online Fetch Fallback: If suggestions are not yet cached, queries LanguageTool with targeted misspelling filtering.
  • Proofing Actions: Renders Add to Dictionary and Ignore All menu items directly beneath the suggestions.
  • Suggestion Application: In ContextMenuActions.applySpelling(suggestion): Replaces the target word, commits the history snapshot, and immediately invokes SpellCheckEngine.run() to clear the squiggly line.

4. Status Bar Auto-Revert & Typing Reset (canvas/text-drag.js)

  • Auto-Revert Timer: Moving or copying text sets #status-msg and initializes a 2.5-second timeout that reverts the text back to "Element Selected" (if an element remains selected) or "Ready".
  • Typing Reset Listener: An input event listener on document detects subsequent keystrokes and clears the timeout immediately, returning the status bar to normal.

πŸ› οΈ Files Modified & Added


πŸ§ͺ Verification & Automated Testing

Validated through automated Playwright end-to-end test suites (test_online_spellcheck.py, test_descenders.py, test_unbroken_spellcheck.py):

Test Scenario Verification Metric Result Output Details
Zero Bundled Dictionary Check that _OPUB_DICT_WORDS is undefined Passed Confirmed zero dictionary files bundled or loaded
Engine Initialization Verify window.SpellCheckEngine is loaded Passed Engine instantiated cleanly with full API
CSS Highlight API Verify CSS.highlights availability Passed W3C CSS Custom Highlight API supported and active
Unbroken Descender Underlines Verify continuous underlines under 'uyfg', 'ykufg', 'kygyugl', 'ggy', 'suppoii' Passed With text-decoration-skip-ink: none, underlines span the whole word without fragmentation
Misspelling Detection Type misspelled word 'mistdake' Passed 'mistdake' detected and marked as bad word
Capitalized Word Non-Flagging Check capitalized words 'This' and 'Apple' Passed 'This' and 'Apple' correctly recognized as good words
Visual Underline Highlighting Check CSS.highlights.get('spelling-error').size Passed Squiggly underline range created and rendered
Add to Dictionary Action Invoke SpellCheckEngine.addToDictionary('mistdake') Passed 'mistdake' cleared from bad words; highlight removed
Ignore All Action Record word 'tehst' and invoke ignoreWord('tehst') Passed 'tehst' marked as not misspelled
Context Menu Right-Click Right-click misspelled word in text box Passed Context menu displays 'mistake', 'Add to Dictionary', and 'Ignore All'
Multi-Zoom Fidelity Test at 60%, 100%, and 150% zoom Passed Squiggly lines remain continuous and crisp at all zoom levels
Status Bar Auto-Revert Move text and wait 2.5 seconds Passed Status message reverts cleanly to 'Element Selected' or 'Ready'
Keystroke Reset Type immediately after text move Passed Status message cleared instantly upon input

βœ… Complete v5.4.6 Feature & Verification Checklist

  • [x] Zero Bundled Dictionaries: Completely removed offline dictionary files, keeping the application lightweight while relying on the existing online spell checker.
  • [x] Visual Spell Check Highlighting: Implemented W3C CSS Custom Highlight API (::highlight(spelling-error)) rendering crisp red squiggly underlines under misspelled words across all zoom levels.
  • [x] Unbroken Continuous Underlines: Added text-decoration-skip-ink: none !important; so descender characters (y, g, p, q, j) do not sever underlines into disjointed fragments.
  • [x] Online Integration with LanguageTool: Leveraged Open Publisher's existing online spell check service with intelligent batching and client-side caching.
  • [x] Casing & Typography Filter: Filtered out non-spelling rules so capitalized words at sentence starts are never falsely flagged as typos.
  • [x] Non-Destructive Range Underlining: Built highlighting engine using DOM Range objects without mutating innerHTML or interfering with undo/redo history.
  • [x] Context Menu Proofing Suite: Added spelling suggestions, "Add to Dictionary", and "Ignore All" to the right-click menu.
  • [x] Persistent Highlighting: Squiggly lines remain visible when text boxes are selected or right-clicked.
  • [x] Print and Export Concealment: Added @media print CSS rules hiding squiggly lines during export or printing.
  • [x] Status Bar 2.5s Auto-Revert: Added auto-revert timer to restore normal status bar messaging after text drag/copy.
  • [x] Keystroke Status Bar Reset: Clear status message immediately when the user resumes typing.
  • [x] Cachebuster Synchronization: Updated all script, stylesheet, and asset cachebusters to ?v=5.4.6.
  • [x] Service Worker Cache: Updated cache name to open-publisher-v5-4-6.
  • [x] Automated Testing: Verified 100% of test scenarios in automated Playwright browser tests.

πŸŽ‰ Version 5.4.6 - Open Publisher

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