taken as a
- title to have it refused, or offline anywhere for a
- network error.
+ Click a title or owner to edit, or focus one and type: Tab moves
+ on to the next. A row's edits are batched into one save
+ after a 600 ms pause. Type taken as a title to have
+ it refused, or offline anywhere for a network
+ error.
>
}
>
@@ -229,9 +230,9 @@ function App() {
title="Adding rows"
description={
<>
- The footer opens a new row at the bottom, where it stays even
- when the list is sorted. Type a title and press Enter to create
- the task, or leave it empty to discard it. Type{' '}
+ The add button opens a new row at the bottom, where it stays
+ even when the list is sorted. Type a title and press Enter to
+ create the task, or leave it empty to discard it. Type{' '}
taken to have the create refused, or{' '}
offline for a network error.
>
diff --git a/docs/architecture.md b/docs/architecture.md
index 932e2b1..1d11100 100644
--- a/docs/architecture.md
+++ b/docs/architecture.md
@@ -88,7 +88,7 @@ Outside a `Sheet`, for example in a test, there's no context. The hooks then do
`useInlineEdit` runs the editor, and `useSheetCellEditing` connects it to the sheet. Both editable cells, `SheetEditableTextCell` and `SheetPrimaryCell` with `editable`, work like this:
-1. **Opening.** Clicking the cell clears its status icon, which would cover the text, but keeps any refused value so a typo can be fixed. The input takes focus as it mounts.
+1. **Opening.** A click, F2 or a typed character opens the editor. A typed character replaces the value, as in a spreadsheet; the others keep any refused value so a typo can be fixed. Opening clears the cell's status icon, which would cover the text. The input takes focus as it mounts, with the caret after the text.
2. **Closing:**
- Enter or blur commits. Tab moves focus on, and the blur commits.
- Escape cancels, dropping the cell's staged value, status and refused value.
diff --git a/docs/decisions.md b/docs/decisions.md
index a6a7c9e..e4b1f4d 100644
--- a/docs/decisions.md
+++ b/docs/decisions.md
@@ -30,6 +30,7 @@ When you make a choice that a future contributor would question, add it here.
## Editing and saving
+- **Typing into a focused cell opens it, replacing the value.** That's how a spreadsheet takes data entry: type, press Tab, type again. The W3C's grid pattern also lists letters and F2 as ways into a cell's editor. Space still opens the editor with the value kept, since it's how a button is pressed. The cost is that one stray key and a click away saves a one-character value, because blur saves. Escape undoes it. Only the built-in cells do this; a cell built on `useInlineEdit` calls `beginEdit(draft)` itself.
- **Outcomes show on the cell:**
- A dot while unsaved, a spinner while saving, a tick once saved, or an error icon with a tooltip. A toast can't say which cell it's about.
- The cell itself isn't tinted, because in a grid with a few bad values, tinting turns it into a wall of red.
@@ -63,6 +64,7 @@ When you make a choice that a future contributor would question, add it here.
- **The filter panel is a native popover, placed with CSS anchor positioning.** The top layer keeps it from being clipped by the sheet's scroll container, and the browser closes it on a click outside and returns focus to its button, so there's no portal and no positioning code. Anchor positioning has been in every major browser since January 2026.
- **Filter controls mount only while the panel is open.** A checklist counts its column's values when it mounts, so a sheet with many filterable columns doesn't count them all on every render. Mounting on open also lets `autoFocus` move focus into the panel, which content that's always mounted couldn't do.
- **No virtualization yet.** Every row is rendered. The playground's 1,000-row demo shows how that performs. Virtualization is planned for a later release.
+- **The add-row button follows the last row,** rather than being pinned to the bottom of the sheet, and sits in the row-number column, where the next row's number would be. It belongs with the rows it adds to, and on a short list a pinned footer left a gap above it. On a long list, you scroll to the end to reach it.
- **No empty gridlines below the last row.** When the rows don't fill the sheet, the space below them stays blank, since empty cells would look like rows that exist.
## Accessibility and languages
diff --git a/packages/sheets/README.md b/packages/sheets/README.md
index 2558f4a..248f968 100644
--- a/packages/sheets/README.md
+++ b/packages/sheets/README.md
@@ -4,7 +4,7 @@ A spreadsheet-style data grid for React. It's built on [TanStack Table](https://

-- **Spreadsheet layout:** row numbers, a sticky header, resizable columns, grouped headers, a sticky add-row footer, and loading and empty states.
+- **Spreadsheet layout:** row numbers, a sticky header, resizable columns, grouped headers, an add-row button below the rows, and loading and empty states.
- **In-place editing:** click a cell, type, then Enter to save or Escape to cancel. Each cell shows its own status: unsaved, saving, saved or refused.
- **Saving per row:** edits to one row can be batched into a single request. If the server refuses a field, the error appears on that field's cell.
- **Validation** with any [Standard Schema](https://standardschema.dev) library (zod, Valibot, ArkType and others).
@@ -333,12 +333,12 @@ function PriorityCell({ value }: { value: number }) {
- `accepts`, which runs the schema and reports a failure on the cell
- `abandon` and `clearOnEditStart`
- `label`, the column's header, for naming your editor
-- `useInlineEdit` handles text-style editors: Enter, Escape, saving on blur, IME input, and returning focus to the cell. It calls `onCancel` on Escape, and when an edit ends with nothing to save.
+- `useInlineEdit` handles text-style editors: Enter, Escape, saving on blur, IME input, and returning focus to the cell. It calls `onCancel` on Escape, and when an edit ends with nothing to save. `beginEdit(draft)` opens the editor on `draft` instead of the value, which is how the built-in cells open on a typed key.
- Report outcomes through `cellStatus`, and `SheetCell` draws the icons.
## Layout and states
-`