@sheetxl/grid-react 0.8.0-beta.1 → 0.8.0-beta.11

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?"
@@ -364,8 +372,9 @@ anchor resolver + Floating UI), not from them:
 
 - **`StickyAnchor`** — resolves a grid anchor (range / cell / edge / point) to a live position;
   children render inline (clipping with the pane) or self-position via render-prop.
-- **`StickyFloat`** — the portal flavor: floats content beside the anchor with flip/shift/clamp.
-- **`HoverTipLayer`** — hover-intent tips: a `Layer` tap probing the hovered cell + a `StickyFloat`.
+- **`StickyPortal`** — the portal flavor: floats content beside the anchor with flip/shift/clamp.
+- **`RangeTooltipLayer`** — the tooltip kind: a `Layer` tap probing the hovered cell + a `StickyPortal` in the
+  group's bubble; `TooltipProvider` sets the timing, the bubble and the single-open group.
 - **`RangePrompt`** — a persistent prompt pinned to a range, with an out-of-view "go to" affordance.
 
 Naming convention: a component ending in `-Layer` roots a `Layer` (drop it in as a grid child);
@@ -390,7 +399,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).