Book-Chapter/BCV selector behavior improvements

[rolfheij-sil]

As a user I want a powerful and intuitive book-chapter-verse selector component so that I can easily navigate to the desired scripture.

In https://github.com/paranext/paranext-core/issues/789 we created a new BCV control. Several behavior improvements were proposed, some of which have already been implemented. The remaining ones are described in this issue.

• [ ] The dropdown list with books should only show books that are in the selected project. Books that haven't been started yet should be disabled. This means that they are greyed out and cannot be selected/expanded
• [ ] When typing in or copying in a reference in the input (so the dropdown menu isn't used at all), the BCV should navigate to that reference when the user presses the Enter key. (If the written/pasted reference is invalid, provide the default error cue in the BCV input - cue currently tbc by UX - likely something like "red outline + icon" or "red outline and shake field")
• [ ] Like in PT9, the elements in the dropdown menu should be in the format GEN Genesis, and not just Genesis. If the book name is also available in localized project format, show this. e.g.: GEN Genesis 1. Mozus
• [ ] The input search field should recognize multiple sorts of input. For example:
  • [ ] It should support short names (PSA), full names (Psalms) and localized names (Psaumes)
  • [ ] Entering space or any punctuation characters should act as valid BCV separators (PSA 62 5, PSA 62:5 or even PSA-62.5)
• [ ] Whenever the input field is clicked, the existing BCV text in the input field should be selected. (The dropdown menu will also open when the input field is clicked. That behavior should be retained, but the input field should get focus)
• [ ] Scrollbar should only be shown when the user scrolls through the list of books/chapters. Otherwise it should be hidden. This is likely an Electron setting that applies to the entire application
• [ ] When scrolling through a long list of chapters, like in Psalms, the name of the book might disappear from view in the book-chapter list. In such cases, we want the book name to be sticky
• [ ] When clicking in the input field, select the current text (e.g. PSA 62:40) and let the user decide whether to overwrite/delete or edit by clicking again or pressing an arrow key. (At the time of editing this issue, the reference in the input field is non-editable ghost text.)
• [ ] When typing a BCV reference in the input field:
  • [ ] The webview should scroll to the verse (with 1.5 lines showing above the start of the verse, as in PT9).
• [ ] Pressing CTRL+B should place the IP in the BCV input field of the current webview, with the BCV
• [ ] When typing in the input field:
  • [ ] Typing letters will filter to books which match what is typed e.g.: P = Psalm, Proverbs, Philemon, Philippians; Ph = Philemon, Philippians. Typing Ge filters only to Genesis, it does not display both Genesis and Judges.
  • [ ] Typing numbers following a valid book name will filter to chapters in this book which match the values being typed. e.g.: In Psalms, typing 1 would filter to 1, 10, 11, 12 [...] 19, 100, 101, 102 [...] 150. If it is possible to add line breaks before 10, 100 this would aid with visual comprehension.
• [ ] A tooltip with keyboard shortcuts (consistent with PT9 shortcuts) appears on mouseover of the control.

[irahopkinson]

For checkbox 2, you could just use form validation that you extend to understand valid VerseRefs. And display form validation errors (with hints on how to fix) below the control. You can use VerseRef to help with form validation, see the second TS example here for VerseRef validation.