julien/typewriter
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

docs: reconcile screen-layout docs with the panel changes

Browse Source 
Mode now sits at the side panel's bottom-left (not its top), and the
words-this-session field is gone. Update the CONTEXT.md field list and
the product-doc mock + prose to match; note the keyboard flag renders
as NO KBD (Latin-9 has no glyph for the mock's symbols).
This commit is contained in:
Julien Calixte
2026-07-08 21:48:32 +02:00
parent ba4a8bfad8
commit ad047cc717
2 changed files with 13 additions and 11 deletions
Download Patch File Download Diff File Expand all files Collapse all files

5
CONTEXT.md
View File

@@ -67,8 +67,9 @@ full-width text region before the side panel carved out its right edge).
**Side panel**:
The right region (~150 px / ~20 cols, full height) holding all metadata:
filename + dirty dot, mode, word count, session, clock, Wi-Fi,
keyboard-disconnect flag, publish state. Sits entirely in the master half
filename + dirty dot, word count, elapsed time, clock, Wi-Fi,
keyboard-disconnect flag, publish state, and the mode indicator at its
bottom-left. Sits entirely in the master half
(right of the `x = 396` seam). Every field is static, event-driven, or
throttled — never per-keystroke.
_Avoid_: header, status line, status bar (retired — the old top header band and

19
docs/v0.1-mvp-product.md
View File

@@ -101,17 +101,17 @@ context," not a full page. Hardware rationale: [ADR-003](adr.md#adr-003-display-
```
┌───────────────────────────────────────────────────────┬─────────────────────┐
│ Lorem ipsum dolor sit amet, consectetur adipiscing │ notes.md ● │
│ elit. Sed do eiusmod tempor incididunt ut labore et │ INSERT │
│ elit. Sed do eiusmod tempor incididunt ut labore et │ │
│ dolore magna aliqua. Ut enim ad minim veniam, quis │ │
│ nostrud exercitation ullamco laboris nisi ut aliquip │ 1 240 words │
│ ex ea commodo consequat. │ +318 this session │
│ ex ea commodo consequat. │ │
│ │ 12:07 elapsed │
│ Duis aute irure dolor in reprehenderit in voluptate │ │
│ velit esse cillum dolore eu fugiat nulla pariatur. │ │
│ Excepteur sint occaecat cupidatat non proident. │ │
│ │ 14:02 │
│ The quick brown fox jumps over the lazy▎ │ Wi-Fi — │
│ │ ✓ pushed abc1234 │
│ │ -- INSERT -- │
└───────────────────────────────────────────────────────┴─────────────────────┘
writing column (~60 cols, full height) side panel (~20 ch)
```
@@ -122,12 +122,13 @@ context," not a full page. Hardware rationale: [ADR-003](adr.md#adr-003-display-
This is the only region that repaints as you type.
- **Side panel** (right, ~150 px / ~20 cols, full height): all metadata lives
here, so the writing column keeps the full height. Top — **filename** + dirty
dot (●/○) and **mode** (always `INSERT` in v0.1). Middle — **word count** and
the **session** (words written + elapsed time), both refreshed on a short
typing pause, *not* per keystroke. Bottom — ambient state: **clock** (if SNTP
has set the time), **Wi-Fi** (`—` = off/on-demand, `✓` = connected,
`✗` = failed), a **keyboard-disconnect** flag (`⌨ ✗`, shown *only* while the
keyboard is dropped; blank when healthy — no permanent `⌨ ✓`, per
dot (●/○). Middle — **word count** and **elapsed time**, refreshed on a short
typing pause, *not* per keystroke. Bottom-left — the **mode** indicator
(always `INSERT` in v0.1) with any pending count/operator echo. Bottom —
ambient state: **clock** (if SNTP has set the time), **Wi-Fi** (`—` =
off/on-demand, `✓` = connected, `✗` = failed), a **keyboard-disconnect** flag
(rendered `NO KBD` — Latin-9 has no `⌨`/`✗` glyph — shown *only* while the
keyboard is dropped; blank when healthy, per
[`CONTEXT.md`](../CONTEXT.md) "No state the user didn't ask for"), and
**publish state**. `Ctrl-S` briefly flashes "saved HH:MM";
`Ctrl-G` transitions through `✓ committed abc1234 · pushing…` at ~0.2 s — the