@sheetxl/grid-react 0.8.0-beta.4 → 0.8.0-beta.6

package/README.md

@@ -304,8 +304,16 @@ const pane = useGridPane();
 The **Stage is the grid's surface** — focus rests on it, and that's what cell navigation uses.
 Programmatically, `gridRef.current.focus()` (or `pane.focus()`) focuses the surface. A `VirtualDiv`
 that should take keyboard focus opts in with `tabIndex` — regular div focus semantics: when it's
-focused it receives keys first (and may `stopPropagation` to keep them from the grid); when the
-surface is focused, keys reach the grid and it navigates as usual.
+focused, keys target it and reach its handlers at its layer's turn (after the taps above it, per
+law 3), and it may `stopPropagation` to keep them from the layers below; when the surface is
+focused, keys reach the grid and it navigates as usual.
+
+A behavior that belongs to the **grid in ready mode** — opening the cell editor on a typed key or a
+double-click — is the floor's, not the top's: put it on its own Layer at the *bottom* of the stack
+(it then hears only what no widget above consumed) and, for keys, act only when the surface itself
+is the event target. A layer that sits high to *paint* (the editor box) must not carry that
+behavior, because its tap would hear every widget's keys first. `EditorStartLayer` + `EditorLayer`
+are this split.
 
 Keys are positionless, so their walk skips hit-testing: **every** layer is offered the key, top of
 z first, then the command system terminates the bubble. There is **no** "is the target an input?"
@@ -390,7 +398,9 @@ Complete, drop-in layers (each roots its own `Layer` — stack them like any oth
   directly on a `GridSurface` when you own the stack.
 - **`SelectionLayer`** — pointer + keyboard selection over an `ISelection` model, with move grip and
   fill handle slots.
-- **`EditorLayer`** — an always-mounted inline cell editor (swappable input).
+- **`EditorStartLayer`** — the ready-mode edit starters (typed key / F2 / double-click); mount it
+  first (the floor).
+- **`EditorLayer`** — an always-mounted inline cell editor (swappable input); mount it last (the top).
 - **`RangesPickerLayer`** — multi-rectangle range picking (formula references, chart ranges).
 - **`List`** — a virtualized list built from the same engine (a one-column grid + selection).