Improve `translations` documentation

Consistently refer to options as "options"

In documentation, UI and error messages, consistently refer to options
af "options", not "settings" and not "prefs".

Don't hide changed notification when exiting Hints mode

For example, if the `f` command is used to click the "Export all" button
in VimFx's settings page in the Add-ons Manager, the export notification
was only visible until `hints.matched_timeout` had passed.

Show pref name for regular options in docs

Update dependencies

- vim-like-key-notation@1.0.1 simply has a smaller download size.

- n-ary-huffman@3.0.0 creates better hints for links with the same area.
  Instead of giving the _last_ of those the best hint, the _first_ one
  gets it.

Implement filtering hints by text and related changes

This brings several more or less breaking changes:

- Non-hint chars now filter hint markers by the text of their elements,
  using an algorithm similar to the location bar (split the search term
  on whitespace; all the items must occur in the search text, case
  insensitively, and may overlap). The matched text is highlighted on
  screen. If all remaining hints are the same, they are automatically
  activated. All of this can be turned off via prefs, though.

- Since space is used to filter hint markers by element text, the
  already existing `<space>` shortcut for rotating hint markers had to
  be changed. It is now `<c-space>`. (`<s-space>` remains unchanged.)

- Uppercase hint chars are now allowed. This is so that people who
  prefer filtering by text in the first hand can use uppercase hint
  chars. If mixed case is used, `text-transform: uppercase;` is not
  applied, to avoid confusion.

- Since using uppercase characters for filtering hint markers by element
  text and lowercase characters for hint chars (or vice versa) is now a
  thing, holding shift no longer lets you peek through the hint markers,
  because that felt like the markers blinking all the time. Instead, you
  now have to hold shift+control to peek through.

- Hint markers are now placed immediately to left of its element's text
  if it would cover the text otherwise. This is because when filtering
  hints by text, it can be quite difficult to see what to type
  otherwise. This also turned out to be helpful even when only using the
  hints (like before). It’s nice being able to see all the link text in
  many cases.

- Hint markers now get their `z-index` assigned based on their element's
  area, not their weight. It's confusing when a smaller element's hint
  cover the hint of a larger element. This could be the case where there
  are lots of small profile image links all with the same `href`.
  Previously, all those links got `z-index` based on their combined
  area. Now, their individual areas are used instead. This problem
  became apparent because of the above bullet point.

- The hint marker(s) with the best hint are now highlighted in blue.

- `<enter>` now activates the highlighted marker(s). `<c-enter>` and
  `<a-enter>` can be used to toggle where links open, just as when
  using those modifiers with the last hint char. However, these
  shortcuts were already taken, so the old ones had to be given new
  shortcuts:

  - "Increase count" now uses `<up>` (instead of `<enter>`).
  - "Toggle complementary" now uses `<c-backspace>` (instead of
    `<c-enter>`).

- All existing hints prefs were renamed from starting with `hint_` or
  `hints_` to starting with `hints.`, for consistency and organization.
  A few new prefs starting with `hints.` were added as well. Migrations
  are written for this.

  This also unveiled a problem. If a config file tries to set an old
  pref and VimFx is upgraded, the config file will throw errors. This is
  bad user experience, so a system for allowing old names was added.
  However, that might mean that users never notice that they use an
  outdated name and never update their config files. Therefore, old
  names are only allowed when the config file is loaded automatically
  (on startup), but _not_ when it is reloaded using `gC`. The idea is
  that people use `gC` while working on their config file, which usually
  involves fixing errors. Then they could just as well fix the old pref
  names as well.

- The options in VimFx's settings page in the Add-ons Manager have been
  slightly re-ordered to play better with the new options added, and to
  promote some very important prefs to the top.

All of the above required some significant refactoring of Hints mode,
that should make it more robust.

Fixes #340. A big thanks to @doy who got this all started with #789.

Make hint markers smaller

The hint markers are styled with `font: menu;` to get as close to the
user's system and preferences as possible. However, that turns out to be
slighly too big on all systems I've seen.

This commit still uses `font: menu;`, but then reduces the font size of
that to 80%, by using a clever CSS trick: `font: menu;` was moved to the
hints container, and the markers themselves use `font-size: 0.8em;`.

Add `ec` for opening the context menu of elements

Fixes #804.

Add `ep` for opening links in new private windows

Fixes #771.

Add `gB` for quickly editing the blacklist

This also improves the description of the blacklist option, mentioning
that the patterns must match the _entire_ URL, since many people seem to
overlook this fact.

Fixes #593 and #677.

Add UI to export, import and reset all prefs

See #262, #245, #267, #625, #802, #713.

Add `gulp hints.html` to help styling hint markers

Fix alphabetic sorting of functions in utils.coffee

Fix missing hint marker activation feedback for `v`

Fix missing hint markers when re-entering Hints mode quickly

1. Enter Hints mode.
2. Press `<escape>` to exit it.
3. Press `f` to re-enter Hints mode within `hints_timeout` milliseconds.

This used to result in re-entering Hints mode as expected, but with no
hint markers on screen because of a timeout from the last Hints mode
session that removed the hints container. Removing the hints container
is done by ID for robustness, so it doesn't help that the hints
container actually is a new DOM element at that time.

This commit fixes the above problem, and makes the logic more robust.

In `onLeave` for Hints mode, it makes sense to always try to remove the
Hints container, so that it may not be accidentally be left on screen.
However, it does not make sense to do so after a timeout, which was
previously the case. Now, it is done _immediately_ instead.

The only case where he timeout is wanted, is when a hint marker just has
been matched. This commit also adds a check in that timeout callback that
Hints mode hasn't been re-entered before removing the hints container.

Fix initial visibility of second-pass hint markers

1. Go to a site where there is a noticeable delay between the two passes
   for the `f` command, such as on reddit.com.
2. Press a prefix hint char there before the second pass has completed.

When the second pass completes, the hint markers for that pass will be
shown, even though they cannot start with the prefix hint char you
pressed. This commit makes sure that the hint markers for the second
pass start out hidden if needed.

Improve hints support for CodeMirror

On https://gcc.godbolt.org/ the `<textarea>` that needs a hint is 0px
wide instead of the usual 1px.

VimFx v0.18.1

Minor documentation fixes. (#801)

Partly revert "Use `prefs.get` directly in events-frame.coffee"

This partly reverts commit e7f361942c2b07234e889804975e93c21c1f5baf.

That commit switched to using `prefs.get` directly in
events-frame.coffee instead of using `messageManager.get`. That avoids
synchronous messages, which is a good thing.

However, I forgot that when doing so, `vimfx.addOptionOverrides` won't
take effect.

This commit partly reverts to getting options via synchronous messages
again. In the very frequent 'keydown' event direct `prefs.get` is still
used for the unlikely-to-be-overridden `focus_previous_key` and
`focus_next_key` prefs, while synchronous messaging is used in the less
frequent 'focus' event, which enables the use case of overriding
`prevent_autofocus` on select pages.

Prevent `vimfx.addOptionOverrides` from crashing on startup

Fixes #795.

Improve the `vimfx.addOptionOverrides` example

See #791.

VimFx v0.18.0

Document that VimFx overrides `'`

Fix documentation typos

Update devDependencies

Change `` ` `` into `'`

This is both for the `` ` `` shortcut (go to mark) and the `` ` `` mark
(last position). Both `` ` `` and `'` are used in Vim. `'` is a better
default, because it is easier to type -- both on an en-US QWERTY
keyboard and, more importantly, on some international layouts, such as
the sv-SE layout.

Refs. #788.

Change `zr` to `gC`

`zr` was the only shortcut starting with `z`. This frees that key up.

Refs. #788.

Change default shortcuts for some hint commands

Many of the old ones were difficult to remember, and there was no space
for adding new ones.

Refs. #788.

Improve docs on "options object" with examples

See #791.

Update fr locale

Refs. #728

Fix uncaught error on click in web page content

Introduced in commit 00eefb39.

Fix broken `yv` command

Regression since commit c4c41736.

Make it possible to create custom hint commands

My first idea was to use `vim.enterMode('hints', ...)`. However, that's
too complicated to be useful for any user.

Actually, I found that `vim.enterMode(...)` is too complicated for most
(all?) modes, so I decided to make it private (removing it from the
public API) while at it. (I also made the arguments of
`vim.enterMode`/`mode.onEnter` more consistent with each other.)

I also considered exposing the entire "API" that the `f` commands use
internally. However, that's more complicated than the average user
needs, and would increase the API surface _a lot._

Instead, the `f` commands now take a `callbackOverride` argument. This
lets you choose the `f` command that matches the elements you're looking
for and the override what happens when a hint marker is matched.

Fixes #785. Fixes #654.

Fix unmousable bottom-right corner of the page scrollbars

VimFx's statuspanel (for notifications) had `pointer-events: auto;`
instead of `pointer-events: none;`, which statuspanels have by default.
The reason was to allow clicking the statuspanel to hide it.

This made it impossible to interact with the bottom-right corner of the
page scrollbars. The invisible statuspanel captured any clicks there.

This commit hides notifications when clicking _anything_ instead, and
removes `pointer-events: auto;`.

Fixes #787.

Fix toggling of the help dialog by the button

Update ru locale (#783)

Refs. #728

VimFx v0.17.4

Update devDependencies

Leave trailing slash when going up path (#781)

Previously:

- `/some/path` → `/some`
- `/some/path/` → `/some`

Now:

- `/some/path` → `/some/`
- `/some/path/` → `/some/`

The convention on most modern sites seem to be to make a trailing slash
optional. But especially on older servers, no trailing slash means "view
file", while a trailing slash means "view directory". Removing the
trailing slash in such cases most likely results in a 404, while
preserving it gives a useful result.

Add support for the TYPO3 CMS fancy text editor

See <https://typo3.org/>.

Fixes #780.

Update ja locale (#779)

Refs. #728

Make it possible to escape from stuck "auto insert mode"

With this commit, `<escape>` resets `vim.focusType` to 'none', in case
we somehow have gotten stuck with 'editable'.

The button now also runs the `esc` command, making it a true escape
hatch: Clicking it not only lets you escape from other modes back to
Normal mode, but also blurs stuff and makes sure that `vim.focusType` is
'none'.

Update de locale

Refs. #728

Update id locale

Refs. #728

Mention a ghacks.net article about VimFx in the README

Update it locale

Refs. #728

Update pt-BR locale

Refs. #728

Update nl locale

Refs. #728

Merge branch 'master' into develop

Prevent `f` commands from crashing in about:config

Regression since commit 1cf724c5.

Hide extra commands with no key sequences

Update es locale (#775)

Refs. #728

Update zh-TW locale (#774)

Refs. #728

Update zh-CN locale (#773)

Refs. #728

Show usage of Hints mode modifiers in the help dialog

Simplify detection of markable `<label>`s

Apparently, such elements have a `.control` property that returns their
associated form control. No need to manually look for the 'for'
attribute or nested form control elements.

Blur focused text input when submitting a form

Fixes #770.

VimFx v0.17.3

Update devDependencies

Teach the `zF` command to find and activate dropmarkers

For example, the bookmarks button has a "star" button on the left, which
acts like a normal button, and another button on the right, which
actually is a `<dropmarker>` and opens a `<menupopup>`. Previously,
VimFx didn't find the `<dropmarker>` (because it hasn't got
`.tabIndex > `-1). Now it does. Note that simulating a click on a
`<dropmarker>` triggers its parent button's action. Instead, the
`<menupopup>` must be found and triggered manually.

Another example of such a button is Greasemonkey’s button. Actually,
this "button with dropmarker" concept seems pretty common among add-ons.

This commit also removes the unnecessary double hint for the bookmarks
button, but filtering out `<toolbarbutton>`s which are direct children
of another `<toolbarbutton>`.

Fixes #766.

VimFx v0.17.2

Add support for scrolling SVG documents

Apparently, the only way to working with scrolling in SVG documents
seems to be by using `window`.

Fixes #764.

Only rotate _visible_ hint markers

Previously, if you pressed `<space>` in Hints mode to rotate overlapping
markers, after already having entered a few hint chars, it would
sometimes look as if nothing happens. This was because _all_ markers
where being rotated, even hidden ones. This commit only rotates _visible_
markers.

Update pt-BR locale

In brazilian portuguese we usually say Timeout as well.

Reference #728.

Update ru locale (#762)

Refs. #728

Improve `<input type="file">` detection for the `f` commands

Fixes #754.

Update pt-BR locale (#761)

Refs. #728

Improve click simulation of XUL elements

- Use `.click()` when possible for the `zF` command as it seems to work
  with more buttons than simulating events the regular VimFx way.

- Add extra code for activating XUL dropdown menus.

- Make it possible to use `zF` to activate VimFx's own button.

- Finally make it possible to click the gear icon in the Add-ons Manager
  using `f`.

Fixes #759.

Fix opening links in new tabs in Firefox 50

`ContentClick.contentAreaClick` now requires passing `originAttributes`
in order not to crash. This affected `<count>f`, `af`, `F` and `gf`.

See https://hg.mozilla.org/mozilla-central/rev/07dc0094e76f

Supersedes and closes #758. Thanks to @XrXr for finding the problem and
suggesting a fix!

VimFx v0.17.1

Fix `zF` double clicking on browser elements (#757)

`nsIDOMWindowUtils.dispatchDOMEventViaPresShell()` dispatches
a 'command' event automatically after a 'click' event on XUL pages.
This was causing `zF` to effectively double click on browser elements,
since VimFx also simulates a 'command' event.

Elements which suffers from this double click include but are not
limited to, the new tab button, question mark circles in the preferences
page and buttons created by the add-on sdk.

Update devDependencies

Fix the "URL popup" not appearing when using `zf`

Fix `zF` crashing when devtools open in Firefox 49

 Update it locale (#753)

Refs. #728

VimFx v0.17.0

Update devDependencies

Fix some `require` sorting

Rename l10n.coffee into translate.coffee

Simplify some code by changing `.bind()` into `->`

Replace `@` with `this` when not used as `@keyword`

Remove outdated comment

Ignore counts in Ignore mode

Add some comments and info for commit 5ca124b4d

Dispatch trusted mouse events to content page (#751)

Some DOM APIs need to be called from the handler of a trusted event to
work. `requestFullscreen()` and `document.execCommand('copy')` are
examples of such API.

Before this patch, VimFx dispatched mouse events using
`element.dispatchEvent()` which had the event handlers for the events
running in untrusted context. This behavior prevented hint mode from
full-screening on Youtube and copying clone addresses on Github.

This patch uses XPCOM to dispatch mouse events as trusted events to the
content page.

See also:
https://www.w3.org/TR/uievents/#trusted-events - info from the spec
https://clipboardjs.com/ - before this patch, copying doesn't work

Improve Marks mode UX

- Return to Normal mode if a mark key hasn't been pressed within
  `options.timeout` milliseconds.

- Let `<escape>` return to Normal mode instead of creating or going to a
  mark named `<escape>`. Previously, if the user pressed `<escape>` as
  an attempt to exit Marks mode after accidentally pressing `m`, that
  would indeed exit Marks mode, but it would also set the `<escape>`
  mark. That meant that after that point, the user couldn't exit Marks
  mode using `<escape>` after having pressed `` ` `` without the side
  effect of scrolling to the `<escape>` mark.

- Marks mode has been hidden from the help dialog, in order not to
  clutter it with unnecessary information. While at it, Find mode was
  removed from the help dialog as well, for the same reason. Both modes
  are still available in VimFx's settings page in the Add-ons Manager,
  though.

Fixes #750.

Fix `[data-command]` being `undefined` in help dialog

Make the `?` command and the button _toggle_ help

I've noticed people (including myself, sometimes) unconsciously
expecting both the `?` command and the button to _close_ the Keyboard
Shortcuts dialog if it is already open.

I don't think there's any need complicating the description of the `?`
command and the tooltip of the button to reflect this.

Improve find commands race condition robustness

Possibly related: #749.

Fix some odd formatting in gulpfile.coffee

Fix being unable to scroll the page on some sites

Remove repeated word in a comment

Drastically speed up `find_from_top_of_viewport`

- Don't recurse into children of elements when looking for visible text
  nodes; we'll get to them anyway since we iterate over every element of
  the page.
- Don't bother checking text nodes that we already know are whitespace
  only.

Fixes #747.

Remove trailing whitespace in fr locale

Update zh-CN locale (#745)

Fix some ambiguous/wrong translations.

Update fr locale (#744)

Refs. #728

Prevent accidental command activation after pressing `/`

Update zh-TW locale (#743)

Refs. #728

VimFx v0.16.1