Proposal: Symbol categories to surface for "Go to Symbol" feature

[rkeithhill]

Visual Studio Code has two related features that this proposal addresses: Go to Symbol and Go to Symbol by Category accessed with Ctrl+Shift+O or Ctrl+P, @ and Ctrl+P, @:. For a JavaScript file, the follow symbols are shown:

And by category:

PowerShell Symbol Categories

For PowerShell, I propose the following categories:

• functions (both simple and advanced as well as filters)
• workflows
• configurations
• classes
• properties (properties within classes)
• methods (methods within classes)
• enums
• variables (script-scope only)

Filters could be a category but they are not significantly different from functions and with the advent of advanced functions, I don't believe filters are widely used anymore.

The JavaScript support only shows global variables - not function-scoped variables. I suggest that we only show script-scope variables as well (assuming this can be determined from the AST). If scope can't be determined from the AST then I propose not showing variables.

[daviwil]

👍

Let's make it happen!

[rkeithhill]

There is a ConfigurationDefinitionAst but the online docs say it was added for PowerShell 5.0.

This element is introduced in Windows PowerShell 5.0.

What's the story here? Do the editor services need to work back to some earlier version of PowerShell. Or can I rely on being able to use this type?

[daviwil]

Go ahead and use the type even though it's PS5 only. At release I'll indicate that this only works for PS5 for now since I've taken a dependency on other v5 only features. My plan is to come up with a multi-version runtime model so that I can support at least PS4 but hopefully PS3 as well.

[Jaykul]

For what it's worth, filters can be "advanced functions" too -- which I would argue just goes to prove they should just show up in the function list ;-)

[rkeithhill]

Just remembered that we have enums now in PowerShell. Need to add that to the list.

[TylerLeonhardt]

Looks like this work is done 😄

Please reopen if you see otherwise.