Lutra/docs/ui-parity.md
danny 9fa6028335 M1.6: tabs and CodeMirror editor
- Editor area with tab bar, CodeMirror 6 view, close question and notices
  (ui/src/components/editor/, ui/src/stores/editor.ts), mounted in App.vue;
  the project tree opens files through the editor store.
- BufferSync: local edits to buffer.edit against the confirmed version,
  one call in flight, resync on stale_version or newer bufferChanged with
  rebase of unsent changes; EngineText maps CodeMirror positions to engine
  UTF-16 offsets for CRLF text.
- Save, save all and close from engine default shortcuts via listCommands.
- Dirty marker, Save / Don't Save / Cancel, non-blocking notice when a
  dirty file changes or disappears on disk.
- Vitest: keystroke bursts with stale versions and remote edits (LF and
  CRLF), mapping, store and component tests against a fake engine.
- Progress docs: Editor core 8% (est.), depth ~1.4%, G2, ui-parity tabs,
  M1 row, architecture, README status.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-15 18:26:32 +02:00

2.9 KiB

UI parity checklist

Status: main window layout (M1.5), project tree running against the engine (M1.4), editor tabs with a CodeMirror editor (M1.6) · Last updated: 2026-10-15

  • Main window: tool window stripes, editor area, status bar, navigation bar
    • M1.5 (2026-10-14): left tool window with header, hide button, collapsed stripe with a show button, resizable by pointer and keyboard; editor area placeholder; status bar. Missing: stripes with several tool windows, bottom/right docking, navigation bar, layout persistence. Not checked in the running app yet (needs M1.4).
  • Project tool window (tree, scroll from source, file operations)
    • M1.5 (2026-10-14): tree of the open folder with lazy project.children listings, folders and PHP files with Lucide icons, ignored/excluded entries dimmed, keyboard navigation (WAI-ARIA tree: arrows, Home/End, Enter), double-click opens, refresh on TreeChanged, listing errors shown in the tree, empty state with Open Folder…. Vitest only, against a mocked engine.
    • M1.4 (2026-10-15): runs against the real engine in the app: projects open from the folder picker or the command line, the tree updates live when files change on disk; checked with ui.screenshot on Windows 11. Missing: scroll from source (Select Opened File), expand/collapse all, views list, sort options, speed search, file colours, file operations. Behaviour notes: plan/phpstorm/02-project-view.md.
  • Editor tabs (pin, split, reorder, close others)
    • M1.6 (2026-10-15): tab bar above a CodeMirror 6 editor; files open from the project tree (Enter, double click) next to the active tab, or from engine events (control channel, page reload); click and Left/Right activate, the close button, a middle click and Mod+W close; a dot marks unsaved changes; closing a dirty tab asks Save / Don't Save / Cancel; Mod+S saves, Mod+Alt+S saves all (shortcuts read from the engine's command specs); a non-blocking notice when a dirty file changes or disappears on disk. Checked with ui.screenshot on Windows 11 and Vitest. Missing: preview tab, pin, split, reorder by drag, close others/all, reopen closed tab, tab limit, tab context menu, recent-files switcher, duplicate-name disambiguation. Behaviour notes: plan/phpstorm/03-editor-tabs.md.
  • Command palette / search everywhere
  • Settings dialog with search
  • Keymap editor (Lutra's own default keymap; no copied keymaps)
  • Light and dark themes from theme tokens
  • Notifications and background task indicator
  • Structure tool window
  • Problems tool window
  • Find tool window
  • Terminal tool window
  • Git tool window

Revision history

Date Change Summary
2026-10-15 minor Editor tabs partial (M1.6)
2026-10-15 minor Project tool window runs against the engine (M1.4)
2026-10-14 minor Notes on main window and project tool window (M1.5)
2026-10-13 major Baseline