Debug: Support launch config grouping and sorting

[joaomoreno]

It would be cool to support grouping in the debug launch configs, such that we can minimize the noise in the picker:

One idea is to mimic the menu API: https://code.visualstudio.com/api/references/contribution-points#Sorting-inside-groups

We could support a group option which would allow to join launch configs together as well as sort them.

We can even have special groups like commandPalette which means that the launch config should only appear in the command palette.
Some other special groups could be hidden - so the launch can only be referenced by compounds, but not launched by the user.

[isidorn]

This makes sense. Assigning to October to look into it this milestone.
The group option would be in the launch configuration. We should maybe filter it out before sending it out to the debug adapter. Whoever we already have some "UX" attributes in the configuration so this shuold not be new teritory.

Related - duplicate #64624

fyi @weinand @roblourens

[isidorn]

Ok, so let's recap what we want to tackle here:

1. Ability to hide launch configurations from the dropdown and from the command palette (after typing debug )
2. Ability to group launch configurations / compounds (groups separated by a visible separator)
3. Ability to sort launch configurations

Here are some proposals how to do that:

1. We add a attribute presentation in the launch configuration which is a structured object. presentation has the following fields (we can add more later):

• visibility: can be hidden, visible, commandPalette
• group: open ended string (name of the group which is not visible in the UX, just used for separation and sorting)
• order: number used for sorting inside a group3

Note that group and order could potentially be merged into one. Example: 1_groupName@5. Here the group is 1_groupName and 5 is the order. We use this for our commands.
The name presentation is taken from tasks reference, however tasks use group for something else (for what we use compounds for).

Example

{
			"name": "Server",
			"type": "node",
			"request": "launch",
			"program": "${workspaceFolder}/src/debugAdapter.ts",
		        "presentation": {
                             "visibility": "hidden",
                             "group": "1_firstGroup",
                             "order": 3
                         }
}

fyi @cstavaru @grbd @alexr00 @weinand @roblourens @joaomoreno

Looking forward to the feedback

[alexr00]

In package.json for ordering of menu items we just have group, no order. Order is instead expressed by @ and then a number:

{
	"command": "command1",
	"group": "1_firstGroup@1"
},
{
	"command": "command2",
	"group": "1_firstGroup@2"
}

For consistency we could keep that pattern.

[cstavaru]

Proposal looks good to me, @alexr00 may also have a valid point.

[isidorn]

@joaomoreno deep appologies since I did not find time for this before going to Spain (requires some refactoring and is not that low hanging). I'll try to put it on a plan for next milestone.

[joaomoreno]