build.sh runs a second, separate typedoc invocation to generate
.metadata.generated.json that never got the --blockTags fix from
0b6492bd, so it hit the same unknown-tag issue.
Silences the "unknown block tag" warning TypeDoc logged for every
@flag/@endflags use, since it didn't recognize them.
--blockTags replaces TypeDoc's whole default list rather than appending,
so we read the defaults at runtime and re-pass them alongside our two
custom tags.
- @flag text now splits on the first blank line into a short label
(shown in the flag list) and longer elaboration prose rendered beneath
it.
- @endflags closes a run of @flag tags and flushes them. This prevents
TSDoc from swallowing any trailing text into the last @flag.
- Markdown headings inside trailing content are also kept out of the
page's sidebar nav to avoid cluttering it with each excmd's subsections.
Extracts @arg -flag description tags from excmd JSDoc into a flags map
in the generated metadata, and renders them as one bullet list in
`:help`.
A docstring can drop a `{{tridactyl-arg-list}}` marker anywhere in its
prose to control where that list renders, since the @arg tags
themselves must stay at the end of the comment (TSDoc runs a block
tag's content until the next tag).
Annotates `hint` as the first user of this new format.
Related to #5397 (which-key), split out per review discussion since
which-key depends on this.
This is kind of dumb because we're assuming all new versions will
forever be backwards compatible. But it is less dumb than assuming
all new minor versions will break everything
Would previously fail with:
```
Running pre-commit hook...
Prettify your files first:
yarn run pretty
If you see this message repeatedly, skip the check with git commit -n
```
Before the commit, it would fail with:
```
1:1 error Definition for rule 'unsupported-apis' was not found unsupported-apis
✖ 1 problem (1 error, 0 warnings)
error Command failed with exit code 1.
```
