Add new beforeBeginEditing hook

[budnix]

Context

The PR adds a new beforeBeginEditing hook that allows controlling when the cell editor can (or not) be opened based on the custom condition. When the hook is not used, or if it returns a value other than a boolean, the default behavior is enabled. By default - which is changed within this PR, a cell editor can not be opened by double mouse click for non-contiguous selection (while pressing Ctrl/Cmd) and for multiple selected cells (while pressing Shift).

Before

After

Hook example usage

Prevent the editor from being opened for the mouse double click. Enter or F2 or API calls would still work.

hot.addHook('beforeBeginEditing', (row, column, initialValue, event, fullEditMode) => {
  return !(event instanceof MouseEvent);
});

Prevent the editor from being opened for specific coordinates (row 0, column 0)

hot.addHook('beforeBeginEditing', (row, column, initialValue, event, fullEditMode) => {
  return row === 0 && column === 0 ? false : true;
});

How has this been tested?

I tested the changes locally and I covered the feature with new tests.

Types of changes

• New feature or improvement (non-breaking change which adds functionality)

Related issue(s):

1. fixes https://github.com/handsontable/dev-handsontable/issues/420
2. fixes https://github.com/handsontable/dev-handsontable/issues/421
3. fixes https://github.com/handsontable/dev-handsontable/issues/480

Affected project(s):

• handsontable

Checklist:

• I have reviewed the guidelines about Contributing to Handsontable and I confirm that my code follows the code style of this project.
• I have signed the Contributor License Agreement
• My change requires a change to the documentation.

[github-actions]

Launch the local version of documentation by running:

npm run docs:review 1e110794b0d82f5465a6485708c2eff6335dc44d

[magierg]

verified with 0.0.0-next-45ef111-20240116 : https://jsfiddle.net/x73hutLm/4/