SCM: Support `scmResourceState` in `when` clauses

[DavidGoldman]

See also #27946 for a related request/question.

The SCM API described here allows you to conditionally add commands to the SCM menus based on the scmProvider and scmResourceGroup, but not based on the scmResourceState.

Conditions on the scmResourceState would be valuable for mercurial extensions (which differentiates between behavior for modified files vs. added files vs. untracked files) without needing to use separate groups for all of them.

[DavidGoldman]

Here's an example of how specific commands make the SCM more intuitive for the user

For a modified file:

• Revert: undo changes
• Remove --force: remove the file even though it is modified

For an added file:

• Untrack: forget the add (hg forget == hg revert == hg remove --force)

For a removed file:

• Restore: restore the file

Using terms instead like revert or remove may be confusing for the user based on the resource state

[vscodebot]

This feature request is now a candidate for our backlog. The community has 60 days to upvote the issue. If it receives 20 upvotes we will move it to our backlog. If not, we will close it. To learn more about how we handle feature requests, please see our documentation.

Happy Coding!

[mjcrouch]

I'm not sure if this will reach 20 upvotes because the people upvoting this will mostly be limited to scm provider extension developers, but this would be a big deal for the perforce extension (or at least my fork of it as the original is not really being updated)

Files in perforce can be shelved, and these are represented in the extension with an additional ResourceState for the shelved file. However the set of commands you can run on a shelved file is very different to the set of commands you can run on a normal file. At the minute, the menu is cluttered up with both, and there's no way to prevent this.

In the image below we have both "revert file" and "delete shelved file" but they are mutually exclusive and one will always show an error

[vscodebot]

This feature request has not yet received the 20 community upvotes it takes to make to our backlog. 10 days to go. To learn more about how we handle feature requests, please see our documentation.

Happy Coding

[llgcode]

We also need it to add/remove menu conditionally on ScmResourceGroup or ScmResource. It will help us organize our menu efficiently

[toja83]

Agree, please fix this issue!