Lutra/docs/ui-parity.md
danny dd98636de4 M1.4: desktop bridge: engine events to the window, folder picker, live project tree
The desktop host publishes every engine event, from commands and from a
pump thread that calls Engine::pump_vfs every 100 ms, to control channel
subscribers and to the window as the Tauri event engine://event, in engine
order. ui/src/ipc.ts gets a typed onEngineEvent; its first subscription
calls engine_ready, and the host replays the current project and buffers,
so a project opened from the command line (lutra-desktop --control PORT
PATH) reaches the UI. project.openDialog returns Effect::PickFolder; the
host shows the native folder picker (tauri-plugin-dialog, licence checked)
and opens the choice, one picker at a time, cancel is not an error.
Capabilities shrink to event listen/unlisten.

Contract fix: the M1.5 project UI assumed shapes the engine does not use.
engineEvents.ts now translates engine events ({kind: projectOpened, ...})
and project.children results ({dir, entries, truncated}) into the UI types,
keeping role and truncated; the store maps listings through
toTreeEntries() and the project tests use the real engine shapes.

Verified in the running app on Windows 11: tree of a project given on the
command line, expanding src, a file created on disk appearing live, the
folder picker opening one dialog and opening the chosen folder.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-15 06:41:49 +02:00

2 KiB

UI parity checklist

Status: main window layout and project tree against a mocked engine (M1.5) · 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)
  • 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 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