Реакция на щелчки и контекстное меню

За смысл книги отвечает контракт операций, за события указателя — ваш интерфейс. Эти обязанности нужно держать раздельно:

Событие или задача	Кто отвечает	Что передавать
Щелчок и двойной щелчок	Ваш интерфейс	Координату, во что попали, текущее выделение
Контекстное меню	Ваш интерфейс	Тип объекта и разрешённые для него команды
Значение или формула ячейки	Ядро	sheetKey, row, col, inputKind, input
Отмена и повтор	Ядро	subsetId и направление
Сохранение	Ядро	subsetId и адрес назначения

Что интерфейс передаёт вместе с щелчком

{
  "subsetId": "subset-...",
  "sheetKey": "xl/worksheets/sheet1.xml",
  "selection": { "top": 0, "left": 0, "rows": 1, "cols": 1 },
  "hit": { "kind": "cell", "row": 0, "col": 0 },
  "pointer": { "kind": "double-click", "button": 0 }
}

По такому объекту интерфейс решает, какое меню показать. Команда, меняющая книгу, затем превращается в строго типизированный запрос к ядру. Не отправляйте в ядро узлы разметки или куски HTML: оно работает с адресами ячеек и типами значений, а не с тем, что нарисовано на экране.

Что такое inputKind

Правка ячейки описывается типом CellInputEdit. Вместе с адресом (sheetKey, row, col) передаётся inputKind — вид ввода. Он определяет, как ядро истолкует переданное, поэтому от него зависит результат. Всего видов тринадцать.

Значение в ячейку. raw-user-input — то, что человек набрал в строке формул: ядро само решит, число это, дата или текст (можно добавить locale). text и number — уже разобранное значение, без угадывания. formula — формула, например =B1*2. legacy-array-formula — формула массива, ей дополнительно нужен refRange.

Очистка. empty-string — пустая строка, clear-to-blank — очистить ячейку, clear-formatting — снять форматирование, оставив значение.

Оформление. formatting — цвет заливки и шрифта, числовой формат, начертание, выравнивание и другие свойства ячейки.

Заполнение и служебное. drag-fill и fill-series — протягивание, prepared-cell — готовая ячейка целиком, sheet-protection — спутник пакетной операции форматирования.

Поля каждого вида — в определении типа.