Improve the list view to be scrollable and auto-adjust the list view height

[daxian-dbw]

PR Summary

Fix #3563
Improve the list view to be scrollable and auto-adjust the list view height.

• Now the list view is scrollable. It can display up to 50 items.
• The max list view height is still 10, but the list view height can auto-adjust based on the terminal height: the max height changes to 5 when the terminal height is <=20, and then changes to 3 when the terminal height is <= 10.
• A metadata line is added to show extra information for the list view.
• When the terminal size is too small to show the list view, it prints a warning message to inform the user about it.
• The key-bindings PageUp and PageDown can navigate within the list view by moving up/down a page.
• The key-bindings Ctrl+PageUp and Ctrl+PageUp can navigate within the list view by jumping to the previous/next source.

The scrollable list view:

The auto-adjustable list view height:

PR Checklist

• PR has a meaningful title
  • Use the present tense and imperative mood when describing your changes
• Summarized changes
• Make sure you've added one or more new tests
• Make sure you've tested these changes in terminals that PowerShell is commonly used in (i.e. conhost.exe, Windows Terminal, Visual Studio Code Integrated Terminal, etc.)
• User-facing changes
  • Not Applicable
  • OR
  • Documentation needed at PowerShell-Docs
    • Doc Issue filed:

Microsoft Reviewers: Open in CodeFlow

[SteveL-MSFT]

The use of italics should just be part of the configurable prediction highlight instead of always being added. Some users may prefer bold, for example. So this should be highlightStyle and not highlightColor

[daxian-dbw]

About the new colors and styles, there are a few of them:

• un-highlighted texts in the metadata line
• highlighted text in the metadata line
• warning message

Currently,

• the un-highlighted text uses the default inline view color/style;
• the highlighted text uses the ListPredictionColor plus italics;
• the warning message uses the ListPredictionColor plus italics;

I'm not sure about what to expose for configuration yet. It doesn't feel needed to expose them all in my opinion. The following are my thoughts:

1. always apply italics to the text rendered in the metadata line, and use the ListPredictionColor as the user-configurable highlighting color/style.
2. maybe expose configuration for un-highlighted text color/style, but I'm not super sure if it's really needed.
3. warning message in this case will be uncommon for users to see because it will usually happen when the terminal height is very small (<5). So, exposing a configuration for it seems overkill to me.

I don't have a clear idea what/how to make configurable about the new color/styles at the moment, so I prefer to wait and collect some feedback about this, which hopefully will give us a clear idea. I will open an issue about this to track it.

[daxian-dbw]

Issue opened: #3584

[andyleejordan]

LGTM!

[daxian-dbw]

@andschwa Thanks for the review! I submitted #3600 to address you feedback.

[ChristopherHaws]

Any idea when this will be released (even to a prerelease version)? I just ran powershell -noprofile -command "Update-Module PSReadLine -AllowPrerelease" and PSReadLine is still on version 2.2.6 and doesnt have these changes.

Thanks! :)

[ghost]

🎉 v2.3.0-beta0 has been released which incorporates this pull request. 🎉