Files
wordcraft/docs/ui-parity.md
T
Valentin KleinandClaude Opus 5.5 4a9078b912 Grey out the AutoSave switch, with the reason, where AutoSave can't save (#196, #176) (#302)
AutoSave writes only a file saved in this session, in a format that keeps
everything (.docx, .docm, .dotx, .dotm, .odt, .rtf, .json), and never in the
browser, where saving is a download. The title-bar switch still showed on for
a saved .md file (#196) and AutoSave looked available in the web app (#176),
so edits stayed unsaved with no explanation.

WordApp::autosave_block() now says why AutoSave can't cover the document
(browser, never saved, a format that can't keep everything, opened but not
saved here). The switch is greyed out with that reason as its tooltip, and
clicking it offers Save As (desktop) so saving as .docx turns AutoSave on.
In the browser, File > Options' AutoSave checkbox is disabled with the same
explanation. file.autosave (scripts, MCP, the switch) now sets the app's
AutoSave and returns the reason as an error when asked to turn it on where it
can't save; turning it off always works. New strings in every catalog.

Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-10 15:37:22 -04:00

4.1 KiB
Raw Blame History

UI parity with Microsoft Word

Last reviewed: 2026-10-10 · Last updated: 2026-10-10 · Change: major (first version; ribbon, dialogs, shortcuts and on-canvas interaction measured from crates/ui-egui and the command registry) · Target: Microsoft Word (Microsoft 365) for Mac 16.113.4

How WordCraft looks and feels next to Word: ribbon, dialogs, panes, keyboard, mouse and touch. Typing behaviour has its own checklist (typing-parity.md). All assets are our own (AGENTS.md: no Microsoft iconography, ever).

Dimension: ~65% (estimated), 65–100 h to full (the sum of the rows below; dialog depth is counted here, not under features).

Area WordCraft Word Parity Hours
Ribbon tabs and groups All Word tabs including contextual Table Design/Layout, Picture Format, Shape Format, Header & Footer, Equation; ribbon overflow (#43, #129). Missing: Draw tab content Same plus Draw 85% (Draw in features)
Keytips (Alt / ⌃⌥ letters) ✅ (#43) ✅ 85% 1–2
Mini-toolbar on selection ✅ (#43) ✅ 80% 1–2
Quick Access Toolbar Undo, Redo, Repeat, AutoSave customizable 50% 2–3
Customize Ribbon / Customize Keyboard ❌ ✅ 0% 6–10
Keyboard shortcuts 101 bound in CommandSpec::key (measured) ~250 default shortcuts ~60% 4–6
Modal dialogs 17 (Dialog enum: Font, Paragraph, Find, Go To, Insert Table, Table Properties, Page Setup, Link, Bookmark, Word Count, Zoom, Watermark, New/Modify Style, Commands, About, Save Changes) plus panes and menus for the rest ~100 (Tabs, Borders and Shading, Columns, Symbol, Field, Caption, Index, TOC options, Citation, Define Multilevel List, Track Changes Options, Compare, Protect, Language, Hyphenation, Line Numbers, Envelopes, Labels, Mail Merge, AutoCorrect, Options panes…) ~40% 20–30
Task panes (Navigation, Styles, Comments, Reviewing, Format Picture/Shape, Thesaurus, Accessibility, Clipboard, Selection) Navigation, Styles, Comments, Thesaurus, Accessibility, Read Aloud, Zotero; Style Inspector (#236); Clipboard pane (#264) open all 70% 4–6
Context menus (right-click) text, spelling suggestions; objects and tables partial rich per context 55% 3–5
Backstage (Home, New, Open, Info, Save As, Print, Share, Export, Options) Home and New separate (#254), Info properties kept (#268) 68% 4–6
Rulers: indents, tabs, margins, table columns indents draggable (one undo, #62); tabs; table column drag pending (#49) ✅ 70% 2–3
On-canvas objects: select, drag, resize handles, nudge ✅ tested (#228) ✅ 75% —
Rotation handle, crop handles on canvas, alignment guides, smart guides ❌ ✅ 0% 4–6
Selection: word/sentence/paragraph clicks, Shift extend, F8 extend mode, column (Alt+drag, #237) ✅ ✅ 85% 1
Zoom: Ctrl+scroll, pinch (#179), zoom buttons (#232), pages side by side when zoomed out (#251) ✅ ✅ 85% —
Touchpad smooth/inertial scroll ✅ (#252) ✅ 90% —
Status bar (page x of y, words, language, view buttons, zoom slider) ✅ ✅ 80% —
Interface themes (light, dark, system #249), dark page (#194) ✅ ✅ 90% —
Platform conventions (macOS menus/traffic lights #255, Windows title bar, Linux CSD on Wayland #78) partial native 70% 3–5
Screen readers (VoiceOver, Narrator, Orca) AccessKit on, document canvas exposure untested full 25% 10–15
Right-to-left (mirrored) interface ❌ ✅ (Arabic, Hebrew Word) 0% in localization

Revision history

Date Change Summary
2026-10-10 trivial AutoSave switch greyed out with a tooltip saying why where AutoSave can't save; Save As from it (#196, #176)
2026-10-10 trivial Table Properties dialog and Table Layout Height/Width boxes (#44)
2026-10-10 minor Merged main: Style Inspector, Column Selection, zoom buttons, inertial scrolling, File Info landed
2026-10-10 major First version: ribbon, dialog, shortcut and interaction inventory