Add Out-ConsoleTableView with native multi-selection and streaming pipeline

- Use TableView's native multi-selection instead of custom mark column
- Stream objects to UI as they arrive from the pipeline (async loading)
- Show spinner and row count during loading, stop on pipeline complete
- Determine columns from first object, add rows incrementally
- UI starts on background thread, signaled ready via OnIsRunningChanged

Co-authored-by: Copilot <[email protected]>

Author: tig

src/Microsoft.PowerShell.ConsoleGuiTools/OutConsoleTableView.cs

@@ -0,0 +1,115 @@
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT License.
+
+using System;
+using System.Collections.Generic;
+using System.Management.Automation;
+using System.Threading;
+using Microsoft.PowerShell.OutGridView.Models;
+using Terminal.Gui.App;
+using Terminal.Gui.Configuration;
+
+namespace Microsoft.PowerShell.ConsoleGuiTools;
+
+/// <summary>
+///     Provides the main orchestration for Out-ConsoleTableView, managing the Terminal.Gui
+///     application lifecycle. Supports both batch (all objects upfront) and streaming
+///     (objects arrive incrementally from the pipeline) modes.
+/// </summary>
+internal sealed class OutConsoleTableView : IDisposable
+{
+    private readonly List<PSObject> _psObjects = [];
+    private readonly TypeGetter _typeGetter = new();
+    private readonly ManualResetEventSlim _uiRunning = new(false);
+    private IApplication? _app;
+    private ApplicationData? _applicationData;
+    private List<DataTableColumn>? _columns;
+    private OutTableViewDataSource? _dataSource;
+    private int _objectIndex;
+    private HashSet<int>? _result;
+    private Thread? _uiThread;
+    private OutTableViewWindow? _window;
+
+    public void Dispose()
+    {
+        _uiRunning.Dispose();
+    }
+
+    /// <summary>
+    ///     Initializes the streaming session. Call this once before feeding objects.
+    /// </summary>
+    public void Initialize(ApplicationData applicationData)
+    {
+        _applicationData = applicationData;
+    }
+
+    /// <summary>
+    ///     Adds an object from the pipeline. On the first object, starts the UI on a background thread.
+    /// </summary>
+    public void AddObject(PSObject psObject)
+    {
+        _psObjects.Add(psObject);
+
+        if (_columns == null)
+        {
+            // First object: determine columns, add first row, then start UI
+            _columns = _typeGetter.GetDataColumnsForObject(psObject);
+            _dataSource = new OutTableViewDataSource(_columns);
+            var row = TypeGetter.CastObjectToDataTableRow(psObject, _columns, _objectIndex++);
+            _dataSource.AddRow(row);
+            StartUi();
+            _uiRunning.Wait();
+        }
+        else
+        {
+            var row = TypeGetter.CastObjectToDataTableRow(psObject, _columns, _objectIndex++);
+            _dataSource!.AddRow(row);
+        }
+
+        // Notify UI thread of new data
+        _app?.Invoke(() => _window?.OnDataChanged());
+    }
+
+    /// <summary>
+    ///     Signals that the pipeline is complete and waits for the UI to finish.
+    ///     Returns the selected indexes.
+    /// </summary>
+    public HashSet<int> Complete()
+    {
+        if (_window == null)
+            return [];
+
+        _app?.Invoke(() => _window.OnPipelineComplete());
+        _uiThread?.Join();
+        return _result ?? [];
+    }
+
+    /// <summary>
+    ///     Gets the PSObject at the given original index (for output).
+    /// </summary>
+    public PSObject GetObject(int index)
+    {
+        return _psObjects[index];
+    }
+
+    private void StartUi()
+    {
+        _uiThread = new Thread(() =>
+        {
+            ConfigurationManager.Enable(ConfigLocations.All);
+
+            _window = new OutTableViewWindow(_applicationData!, _dataSource!)
+            {
+                OnRunning = () => _uiRunning.Set()
+            };
+            _app = Application.Create().Init(_applicationData!.Driver);
+            _result = _app.Run(_window) as HashSet<int>;
+            _app.Dispose();
+        })
+        {
+            IsBackground = true,
+            Name = "OutConsoleTableView-UI"
+        };
+        _uiThread.Start();
+    }
+}

src/Microsoft.PowerShell.ConsoleGuiTools/OutConsoleTableViewCmdletCommand.cs

@@ -0,0 +1,185 @@
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT License.
+
+using System;
+using System.Collections;
+using System.Collections.Generic;
+using System.Management.Automation;
+using System.Management.Automation.Internal;
+using Microsoft.PowerShell.OutGridView.Models;
+
+namespace Microsoft.PowerShell.ConsoleGuiTools;
+
+/// <summary>
+///     Sends output to an interactive table using Terminal.Gui's TableView.
+///     This cmdlet uses the same pipeline model as Out-ConsoleGridView (collecting objects
+///     in ProcessRecord, displaying in EndProcessing) but renders with TableView for
+///     native column headers, sizing, and horizontal scrolling.
+/// </summary>
+[Cmdlet(VerbsData.Out, "ConsoleTableView")]
+[Alias("octv")]
+public class OutConsoleTableViewCmdletCommand : PSCmdlet, IDisposable
+{
+    #region Properties
+
+    private const string DATA_NOT_QUALIFIED_FOR_TABLE_VIEW = nameof(DATA_NOT_QUALIFIED_FOR_TABLE_VIEW);
+    private const string ENVIRONMENT_NOT_SUPPORTED_FOR_TABLE_VIEW = nameof(ENVIRONMENT_NOT_SUPPORTED_FOR_TABLE_VIEW);
+
+    private readonly OutConsoleTableView _outConsoleTableView = new();
+    private bool _initialized;
+
+    #endregion Properties
+
+    #region Input Parameters
+
+    /// <summary>
+    ///     Gets or sets the current pipeline object.
+    /// </summary>
+    [Parameter(ValueFromPipeline = true, HelpMessage = "Specifies the input pipeline object")]
+    public PSObject InputObject { get; set; } = AutomationNull.Value;
+
+    /// <summary>
+    ///     Gets or sets the title of the Out-ConsoleTableView window.
+    /// </summary>
+    [Parameter(HelpMessage =
+        "Specifies the text that appears in the title bar of the Out-ConsoleTableView window. By default, the title bar displays the command that invokes Out-ConsoleTableView.")]
+    [ValidateNotNullOrEmpty]
+    public string? Title { get; set; }
+
+    /// <summary>
+    ///     Gets or sets a value indicating whether the selected items should be written to the pipeline
+    ///     and if it should be possible to select multiple or single list items.
+    /// </summary>
+    [Parameter(HelpMessage =
+        "Determines whether a single item (Single), multiple items (Multiple; default), or no items (None) will be written to the pipeline. Also determines selection behavior in the TUI.")]
+    public OutputModeOption OutputMode { set; get; } = OutputModeOption.Multiple;
+
+    /// <summary>
+    ///     Gets or sets the initial value for the filter in the TUI.
+    /// </summary>
+    [Parameter(HelpMessage =
+        "Pre-populates the Filter edit box, allowing filtering to be specified on the command line. The filter uses regular expressions.")]
+    public string? Filter { set; get; }
+
+    /// <summary>
+    ///     Gets or sets a value indicating whether "minimum UI" mode will be enabled.
+    /// </summary>
+    [Parameter(HelpMessage = "If specified no window frame, filter box, or status bar will be displayed in the TUI.")]
+    public SwitchParameter MinUI { set; get; }
+
+    /// <summary>
+    ///     Gets or sets the Terminal.Gui driver to use.
+    /// </summary>
+    [Parameter(HelpMessage =
+        "Forces the Terminal.Gui driver to use. Valid values are 'ansi', 'windows', or 'unix'.")]
+    public string? ForceDriver { set; get; }
+
+    /// <summary>
+    ///     Gets a value indicating whether the Verbose switch is present.
+    /// </summary>
+    public bool Verbose => MyInvocation.BoundParameters.ContainsKey("Verbose");
+
+    /// <summary>
+    ///     Gets a value indicating whether the Debug switch is present.
+    /// </summary>
+    public bool Debug => MyInvocation.BoundParameters.ContainsKey("Debug");
+
+    #endregion Input Parameters
+
+    /// <summary>
+    ///     Validates that the environment supports the table view.
+    /// </summary>
+    protected override void BeginProcessing()
+    {
+        if (Console.IsInputRedirected)
+        {
+            var error = new ErrorRecord(
+                new PSNotSupportedException("Not supported in this environment (when input is redirected)."),
+                ENVIRONMENT_NOT_SUPPORTED_FOR_TABLE_VIEW,
+                ErrorCategory.NotImplemented,
+                null);
+
+            ThrowTerminatingError(error);
+        }
+    }
+
+    /// <summary>
+    ///     Processes each input object received from the pipeline.
+    /// </summary>
+    protected override void ProcessRecord()
+    {
+        if (Equals(InputObject, AutomationNull.Value)) return;
+
+        if (InputObject.BaseObject is IDictionary dictionary)
+            // Dictionaries should be enumerated through because the pipeline does not enumerate through them.
+            foreach (DictionaryEntry entry in dictionary)
+                ProcessObject(PSObject.AsPSObject(entry));
+        else
+            ProcessObject(InputObject);
+    }
+
+    private void ProcessObject(PSObject input)
+    {
+        var baseObject = input.BaseObject;
+
+        // Throw a terminating error for types that are not supported.
+        if (baseObject is ScriptBlock ||
+            baseObject is SwitchParameter ||
+            baseObject is PSReference ||
+            baseObject is PSObject)
+        {
+            var error = new ErrorRecord(
+                new FormatException("Invalid data type for Out-ConsoleTableView"),
+                DATA_NOT_QUALIFIED_FOR_TABLE_VIEW,
+                ErrorCategory.InvalidType,
+                null);
+
+            ThrowTerminatingError(error);
+        }
+
+        if (!_initialized)
+        {
+            _initialized = true;
+            var applicationData = new ApplicationData
+            {
+                Title = Title ?? "Out-ConsoleTableView",
+                OutputMode = OutputMode,
+                Filter = Filter,
+                MinUI = MinUI,
+                Driver = ForceDriver,
+                Verbose = Verbose,
+                Debug = Debug,
+                ModuleVersion = MyInvocation.MyCommand.Version.ToString()
+            };
+            _outConsoleTableView.Initialize(applicationData);
+        }
+
+        _outConsoleTableView.AddObject(input);
+    }
+
+    /// <summary>
+    ///     Performs final processing after all pipeline objects have been received.
+    ///     Signals the UI that loading is complete and writes selected objects to the pipeline.
+    /// </summary>
+    protected override void EndProcessing()
+    {
+        base.EndProcessing();
+
+        if (!_initialized) return;
+
+        HashSet<int> selectedIndexes = _outConsoleTableView.Complete();
+        foreach (var idx in selectedIndexes)
+        {
+            WriteObject(_outConsoleTableView.GetObject(idx), false);
+        }
+    }
+
+    /// <summary>
+    ///     Releases all resources.
+    /// </summary>
+    public void Dispose()
+    {
+        _outConsoleTableView.Dispose();
+        GC.SuppressFinalize(this);
+    }
+}