| Name | Modified | Size | Downloads / Week |
|---|---|---|---|
| Parent folder | |||
| OpenPublisher5-i386-windowsXP.exe | 2026-11-11 | 56.5 MB | |
| openpublisher5_amd64-windows-portable.exe | 2026-11-11 | 183.2 MB | |
| openpublisher5_amd64-windows.exe | 2026-11-11 | 165.2 MB | |
| openpublisher5_amd64-macos.dmg | 2026-11-11 | 233.1 MB | |
| openpublisher5_amd64-linux.run | 2026-11-11 | 193.4 MB | |
| openpublisher5_amd64-linux.rpm | 2026-11-11 | 215.4 MB | |
| openpublisher5_amd64-linux.flatpak | 2026-11-11 | 153.6 MB | |
| openpublisher5_amd64-linux.deb | 2026-11-11 | 156.2 MB | |
| openpublisher5_amd64-linux.AppImage | 2026-11-11 | 166.4 MB | |
| openpublisher5_amd64-freebsd.pkg | 2026-11-11 | 185.5 MB | |
| 5.20.1_ AI Command Gating, Contrast Protection, Watermark Reset _ ClipArt Lookup Fixes source code.tar.gz | 2026-11-11 | 103.7 MB | |
| 5.20.1_ AI Command Gating, Contrast Protection, Watermark Reset _ ClipArt Lookup Fixes source code.zip | 2026-11-11 | 104.2 MB | |
| README.md | 2026-11-11 | 8.8 kB | |
| Totals: 13 Items | 1.9 GB | 0 | |
π Summary
Version 5.20.1 hardens the AI Layout & Command Assistant introduced in v5.20.0 by preventing unrequested workspace changes, guaranteeing readable text contrast on every AI-generated element, clearing leftover document watermarks across new publications and template loads, and replacing literal text placeholder boxes on ClipArt items with real stemmed library matches, built-in vector SVG artwork, and Iconify lookups.
Complete application version synchronization has also been applied across the Service Worker cache (open-publisher-v5-20-1-1), About dialog, script and asset cachebusters, engine logs, and documentation badges.
π οΈ Key Fixes & Enhancements
1. Unprompted Workspace Command Gating (extensions/ai-assistant.js)
APP COMMANDS RULESystem Prompt Instruction (buildAISystemPrompt):- Instructs the model to leave
appCommandsempty ({}) unless the user explicitly asks to change the application UI theme, dark/light mode, guides, grids, baselines, bounds, spreads, proofing, or tools, keeping creative page-styling requests routed throughpageConfig.colorSchemeorpageConfig.pageTheme. - Intent-Gated Execution (
gateAppCommands,applyAILayoutResponse): - Filters
appCommandsagainst explicit regex checks on the user prompt (UI_THEME_INTENT_RE,GUIDES_INTENT_RE,VIEW_AID_INTENT_RE) before executing commands:uiThemeruns only when the prompt mentions UI theme, dark/light mode, app theme, or interface.toggleGuidesruns only when guides or margin guides are explicitly requested.toggleGrid,toggleBaselines,toggleBounds, andtoggleSpreadsrun only when grid, baselines, bounds/boundaries, or spreads are explicitly requested.
2. Automatic WCAG Text-to-Background Contrast Enforcement (extensions/ai-assistant.js)
- System Prompt Readability Guidance (
CONTRAST RULE): - Requires light text (
#ffffffor#f8fafc) on dark backgrounds and dark text (#0f172aor#1e293b) on light backgrounds or light cards placed over dark pages. - Runtime WCAG Luminance Guard (
ensureReadableContrast,fixElementContrast): - Computes WCAG relative luminance across solid fills, CSS variables, rgba alpha layers, gradients, and underlying page backgrounds (
getPageBackgroundRgb,getEffectiveBackgroundRgb). - Automatically checks
text_box,styled_text_box,shapelabels,table,styled_table,coupon,page_part,business_info,symbol, andcustom_htmlnodes after placement, overriding text colours with a contrast ratio below4.2to#ffffff(when background luminance< 0.42) or#0f172a(when luminance>= 0.42).
3. Watermark Lifecycle Cleanup (extensions/watermark-engine.js, core/pages.js, ui/dashboard.js, elements/templates/templates.js, extensions/ai-assistant.js)
- Silent Watermark Reset API (
WatermarkEngine.remove(silent),window.resetDocumentWatermark): - Added silent suppression mode on
remove(true)so internal resets clearstate.watermarkand remove#page-watermarkwithout pushing duplicate history entries or triggering notifications. - Automatic Reset Across Entry Points:
- Cleared lingering watermarks when creating a new blank document (
DashboardSystem.startBlank,handleNewDocument), loading a publication template (loadTemplate), or running an AI layout withclearCurrentPage: trueunless the new plan explicitly includespageConfig.watermark.
4. Real Multi-Tier ClipArt Resolution (extensions/ai-assistant.js)
- Stemmed Library Matching (
findLocalClipart,tokenizeWords,stemWord): - Removed the fallback that rendered grey boxes containing raw query words and instead builds an indexed stem token lookup across
webClipartLibrary/window.CLIPART_DATAso plurals and partial descriptions match real artwork (for example"tree"and"christmas trees"resolve to tree illustrations). - Built-In SVG, Iconify API & Text-Free Offline Fallback (
findBuiltinClipart,fetchIconifyDataUri,resolveClipartSource): - Falls back cleanly from the clipart library to curated built-in multi-stop SVG illustrations (
tree,star,gift,heart,trophy,rocket,sun,flower,balloon,lightbulb), then to live vector SVG search via the Iconify API, and finally to a clean text-free geometric vector star (GENERIC_CLIPART_SVG) when offline.
β Browser Verification Coverage
Executed both automated Playwright suites in headless Chromium against a local server serving index.html:
- Fix Verification Suite (
scratch/test_fixes.py- 20/20 checks passing,service_workers="block", mocked Iconify/CDN endpoints): - Verified unprompted
uiTheme,toggleGuides,toggleGrid,toggleBaselines, andtoggleBoundscommands are blocked unless explicitly requested, and apply cleanly when requested. - Confirmed
buildAISystemPrompt()outputsAPP COMMANDS RULE,CONTRAST RULE, andSPACING RULE. - Confirmed WCAG contrast overrides (
ratio < 4.2) fix dark text on dark pages, white text on white cards over dark pages, and white text labels on yellow shapes while preserving compliant light text. - Verified stale watermarks clear completely (
!state.watermarkand no#page-watermark) onclearCurrentPage,DashboardSystem.startBlank('A4'), andloadTemplate. - Confirmed fuzzy stemmed matching for
"tree"and"christmas trees", built-in SVG fallback ("rocket"), mocked Iconify SVG lookup ("zzqx widget"), text-free generic SVG when offline ("qqwv gizmo"), removal of legacy text-box fallback code, and zero uncaught page errors. - Core AI Regression Suite (
scratch/test_ai_assistant.py- all assertions passing, mocked worker & stubbed CDN endpoints): - Verified
AIAssistant.VERSION === "5.20.1", About dialogv5.20.1,AI.pngtheme hue shifting, UUID persistence, prompt validation, 20s cooldown,503rollover,429stop, all 21 element types at millimeter coordinates, CSS scoping isolation, single-stepCtrl+Zundo, and zero unexpected console or page errors.
π Version Synchronization (v5.20.1)
| Component | Target Version | Updated Reference |
|---|---|---|
| Service Worker | v5.20.1 |
open-publisher-v5-20-1-1 and header comment in sw.js |
| AI Assistant Engine | v5.20.1 |
Header version and AIAssistant.VERSION (5.20.1) in extensions/ai-assistant.js |
| About Dialog & UI Interactions | v5.20.1 |
Header comment, Knowledge Base icon query strings, and About dialog (β’ v5.20.1) in extensions/ui-interactions.js |
| Print & Watermark Engines | v5.20.1 |
Header comment in extensions/print-engine.js; header and init log in extensions/watermark-engine.js |
| Proofing & Spellcheck | v5.20.1 |
Headers and load log in tools/proofing/dictionary.js and tools/proofing/spellcheck-engine.js |
| PWA Installer | v5.20.1 |
Service worker registration sw.js?v=5.20.1 in extensions/pwa-install.js |
| Application Cachebusters | v5.20.1 |
All script, style, and image asset query strings updated to ?v=5.20.1 in index.html |
| Dashboard & Template Assets | v5.20.1 |
ui/dashboard.js and elements/templates/templates.js (getTemplateAssetUrl) |
| README Badges | v5.20.1 |
Badge image query strings updated to ?v=5.20.1 in README.md |
β Checklist Completed
- [x] Gate unprompted
appCommands(uiTheme,toggleGuides,toggleGrid,toggleBaselines,toggleBounds,toggleSpreads) on explicit user intent (gateAppCommands) and prompt rules - [x] Add WCAG relative luminance guard (
ensureReadableContrast,fixElementContrast) across AI text-bearing elements and shapes - [x] Clear stale watermarks silently across new blank documents, template loads, and AI
clearCurrentPageresets - [x] Replace literal text-placeholder ClipArt fallback with stemmed library search, built-in vector SVGs, Iconify API lookup, and clean geometric offline graphic
- [x] Restore
v5_20_0_release_notes.mdto its original v5.20.0 scope and writev5_20_1_release_notes.mdoutside the project directory - [x] Synchronize
v5.20.1across Service Worker (open-publisher-v5-20-1-1), About dialog, scripts, cachebusters, and badges - [x] Re-run both Playwright suites (
test_fixes.py20/20 +test_ai_assistant.py) after final version edits with zero unexpected errors - [x] Commit all v5.20.1 changes locally on
main(leavinggit pushto user)
π Version 5.20.1 - Open Publisher