Improve outline view

[mads-hartmann]

Currently the outline view simply shows a flat list of all symbols in the file. I believe that you can get a hierarchical view if you return a bit more information (I think it's the name of the parent)

[rcjsuen]

This isn't really supported in the current specification. Also see microsoft/language-server-protocol#327 and its many referenced issues and so on.

/**
 * The name of the symbol containing this symbol. This information is for
 * user interface purposes (e.g. to render a qualifier in the user interface
 * if necessary). It can't be used to re-infer a hierarchy for the document
 * symbols.
 */
containerName?: string;

[laughedelic]

Notice that the parent name is not enough. See discussion in facebookarchive/atom-ide-ui#121 and facebookarchive/atom-ide-ui#121 (comment) in particular for the summary.

TL;DR: LSP doesn't allow you to rely on containerName for the hierarchy. But you can use nested location ranges to nest the tree nodes. It works in Atom IDE UI and it works with the VS Code outline extension.

[mads-hartmann]

@laughedelic Thanks a lot, that was super helpful 👍 I've opened a PR #31 now which seems to do the trick in both Atom and Code. I will probably merge if early next week and cut a release with some other new features as well :)

[mads-hartmann]

We won't improve the outline view further until it's a proper part of the LSP definition.