v0.6.1 aa12db3

0005-identity-and-events.md RawHistoryFolder

ADR 0005 — Immediate-mode identity and events

Status: accepted

Identity

  • Key is a stable identity local to the parent. ID is CSS metadata only.
  • Without a key, identity is parent identity + local child position + element type.
  • Dynamic or reordered collections need explicit keys. Debug builds report duplicate sibling keys, stale Node use and suspicious unkeyed sequence changes.

Events

  • Input is hit-tested against the last committed layout. The target identity is queued, the UI loop wakes, pending events are batched and one frame is built.
  • The event is delivered to the matching element in that frame, is idempotent while the frame runs, and expires at the end of the frame.
  • No user code runs outside frame construction.
  • Pointer-backed controls may change the pointed value during their call, never keep the pointer, and later calls in the same frame see the new value.
  • Controls declared earlier in that frame painted the previous value, so every event batch is followed by exactly one event-free frame that shows the settled state. That frame schedules nothing further.
source
1# ADR 0005 — Immediate-mode identity and events
2
3Status: accepted
4
5## Identity
6
7- `Key` is a stable identity local to the parent. `ID` is CSS metadata only.
8- Without a key, identity is `parent identity + local child position + element type`.
9- Dynamic or reordered collections need explicit keys. Debug builds report duplicate sibling keys, stale `Node` use and suspicious unkeyed sequence changes.
10
11## Events
12
13- Input is hit-tested against the last committed layout. The target identity is queued, the UI loop wakes, pending events are batched and one frame is built.
14- The event is delivered to the matching element in that frame, is idempotent while the frame runs, and expires at the end of the frame.
15- No user code runs outside frame construction.
16- Pointer-backed controls may change the pointed value during their call, never keep the pointer, and later calls in the same frame see the new value.
17- Controls declared earlier in that frame painted the previous value, so every event batch is followed by exactly one event-free frame that shows the settled state. That frame schedules nothing further.

Keyboard shortcuts

Single-key shortcuts are on. ctrl k and esc work whatever this says.

ctrl k :
go to a section, branch, tag, file or repository
?
this list
j k
move the row cursor down / up
enter
open the row under the cursor; on Files, a directory opens or closes in place
↑ ↓ ← → home end
in the file tree (focus on a row): previous / next row, close / open a directory or go to its parent / first entry, first / last row. They never open a file
l h
on Files: open a directory or a file / close a directory or go up to its parent, then to the parent page. Elsewhere: into the side panel (on a merge request, its files) / back to the content; there j k move between its controls
g g G
first / last row
/
filter the list; on Files, find a file anywhere in the repository (esc clears, enter opens the best match)
b
switch branch or tag
g s g f g c g b g m g i g r g a
tabs: summary, files, commits, branches & tags, merge requests, issues, releases, actions (when available)
g h
home
w
wide mode: use the whole width of the screen, or not (remembered)
y
copy a permalink pinned to the commit
d u x
diff: split / unified / collapse or expand all
e E
diff: the whole file in view / every file, with the lines the hunks hide
n
merge request: next note in the diff
esc
close a dialog, leave a field

Branches 1

Tags 12

↑↓ moveenter openesc close