Download Latest Version openpublisher5g_amd64-windows.exe (81.1 MB)
Home / 5.20.1
Name Modified Size InfoDownloads / 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.

op-AIAssistantHardeningAndAssetEngineUpgrades


πŸ› οΈ Key Fixes & Enhancements

1. Unprompted Workspace Command Gating (extensions/ai-assistant.js)

  • APP COMMANDS RULE System Prompt Instruction (buildAISystemPrompt):
  • Instructs the model to leave appCommands empty ({}) 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 through pageConfig.colorScheme or pageConfig.pageTheme.
  • Intent-Gated Execution (gateAppCommands, applyAILayoutResponse):
  • Filters appCommands against explicit regex checks on the user prompt (UI_THEME_INTENT_RE, GUIDES_INTENT_RE, VIEW_AID_INTENT_RE) before executing commands:
    • uiTheme runs only when the prompt mentions UI theme, dark/light mode, app theme, or interface.
    • toggleGuides runs only when guides or margin guides are explicitly requested.
    • toggleGrid, toggleBaselines, toggleBounds, and toggleSpreads run 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 (#ffffff or #f8fafc) on dark backgrounds and dark text (#0f172a or #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, shape labels, table, styled_table, coupon, page_part, business_info, symbol, and custom_html nodes after placement, overriding text colours with a contrast ratio below 4.2 to #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 clear state.watermark and remove #page-watermark without 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 with clearCurrentPage: true unless the new plan explicitly includes pageConfig.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_DATA so 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, and toggleBounds commands are blocked unless explicitly requested, and apply cleanly when requested.
  • Confirmed buildAISystemPrompt() outputs APP COMMANDS RULE, CONTRAST RULE, and SPACING 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.watermark and no #page-watermark) on clearCurrentPage, DashboardSystem.startBlank('A4'), and loadTemplate.
  • 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 dialog v5.20.1, AI.png theme hue shifting, UUID persistence, prompt validation, 20s cooldown, 503 rollover, 429 stop, all 21 element types at millimeter coordinates, CSS scoping isolation, single-step Ctrl+Z undo, 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 clearCurrentPage resets
  • [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.md to its original v5.20.0 scope and write v5_20_1_release_notes.md outside the project directory
  • [x] Synchronize v5.20.1 across Service Worker (open-publisher-v5-20-1-1), About dialog, scripts, cachebusters, and badges
  • [x] Re-run both Playwright suites (test_fixes.py 20/20 + test_ai_assistant.py) after final version edits with zero unexpected errors
  • [x] Commit all v5.20.1 changes locally on main (leaving git push to user)

πŸš€ Version 5.20.1 - Open Publisher

Source: README.md, updated 2026-11-11